PHPackages                             tessera/installer - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [CLI &amp; Console](/categories/cli)
4. /
5. tessera/installer

ActiveProject[CLI &amp; Console](/categories/cli)

tessera/installer
=================

Tessera AI-Native CMS Installer — AI builds your project

v3.11.4(3w ago)028PolyForm-Noncommercial-1.0.0PHPPHP ^8.4CI passing

Since Mar 13Pushed 3w agoCompare

[ Source](https://github.com/drnasin/tessera-installer)[ Packagist](https://packagist.org/packages/tessera/installer)[ RSS](/packages/tessera-installer/feed)WikiDiscussions master Synced 2w ago

READMEChangelogDependencies (7)Versions (38)Used By (0)

Tessera Installer
=================

[](#tessera-installer)

[![Tests](https://github.com/drnasin/tessera-installer/actions/workflows/tests.yml/badge.svg)](https://github.com/drnasin/tessera-installer/actions/workflows/tests.yml)[![PHP](https://camo.githubusercontent.com/270717987f5341772d79b57567226e54ed27b2d4199bbdc98a96e2edf24902fa/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e342532422d3737374242343f6c6f676f3d706870266c6f676f436f6c6f723d7768697465)](https://www.php.net/)[![License](https://camo.githubusercontent.com/e1c1daceeb505ebe180db5854437fd7e686fd380cf5391a70e14cd6cca0fa5ed/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d536f757263652d2d617661696c61626c652d626c7565)](LICENSE.md)

Website: **[tessera-ai.net](https://tessera-ai.net)** · Docs: [tessera-ai.net/docs](https://tessera-ai.net/docs/what-is-tessera)

> Describe your project. AI builds it.
>
> One command, one conversation, one production-ready codebase. Tessera turns the AI CLI tools you already have (Claude, Codex, Gemini) into an inspectable, resumable build orchestrator.

> **Important:** Tessera uses **your own** AI CLI tools and **your own** subscription. Each call burns tokens from your plan. Generated code may contain bugs, security issues, or wrong implementations. Always review before shipping. See [Disclaimer](#disclaimer).

Install in 30 seconds
---------------------

[](#install-in-30-seconds)

```
composer global require tessera/installer
```

Make sure the Composer global bin directory is in your `PATH`:

OSPathWindows`%APPDATA%\Composer\vendor\bin`macOS / Linux`~/.composer/vendor/bin````
tessera --version
tessera doctor    # check that your system is ready
```

Build your first project
------------------------

[](#build-your-first-project)

```
tessera new my-restaurant
```

Tessera asks five questions (business, languages, payments, design, scale), picks the right stack, and runs the AI build. Coffee break — the typical Laravel build is 10–15 minutes.

[Full walkthrough →](https://tessera-ai.net/docs/creating-project)

See what AI is about to do
--------------------------

[](#see-what-ai-is-about-to-do)

Before you spend a single token, compile and inspect the build plan:

```
tessera plan compile stacks/laravel.yaml
tessera plan show          # pretty-print every step
tessera plan diff a.json b.json    # what changed?
```

Every plan is hash-anchored. Tweak a prompt, recompile, diff — you see exactly what shifted. [`tessera plan` reference →](https://tessera-ai.net/docs/cli/plan)

Available stacks
----------------

[](#available-stacks)

StackBest forWhere the recipe lives**Laravel + Filament**CMS, e-commerce, admin panels[`stacks/laravel.yaml`](stacks/laravel.yaml)**Node.js / Next.js**API servers, SaaS, real-time apps[`stacks/node.yaml`](stacks/node.yaml)**Go**High-performance backends, microservices[`stacks/go.yaml`](stacks/go.yaml)**Flutter**Mobile (iOS + Android + web)[`stacks/flutter.yaml`](stacks/flutter.yaml)**Static**Landing pages, portfolios, event sites[`stacks/static.yaml`](stacks/static.yaml)Every stack is described in YAML. The same engine drives them all. [Authoring a custom stack →](https://tessera-ai.net/docs/architecture/yaml-manifests)

What you get out of the box
---------------------------

[](#what-you-get-out-of-the-box)

- **Inspectable plans.** `tessera plan compile/show/diff` — no tokens spent until you say go.
- **Quality gates.** Each step declares post-checks (`exists_any`, `exists_all`) so the AI saying "done!" against an empty directory fails loudly.
- **Skippable enrichment.** Polish steps and SETUP.md generators that hit a transient rate limit don't abort a 25-minute build.
- **Build trace.** Every run leaves `.tessera/state.json` + `.tessera/events.jsonl` + `.tessera/plan.json`. Post-mortem any build with `jq` and a few seconds.
- **Resume.** Crash, Ctrl+C, network drop — run the same command, pick up where it left off. Atomic state writes survive interrupts.
- **Cross-OS process control.** Windows `taskkill /F /T`, Unix `pgrep -P` + `posix_kill`. Tessera never leaves zombie AI subprocesses pinned to your terminal.
- **Plan-aware AI routing.** Claude Max gets all the steps; free-tier accounts hit fallback chains. Rate limits cause a 2-minute cooldown and a tool switch, not a build crash.
- **AI tool isolation.** Every AI subprocess — whether spawned through the adapter path or the legacy router — runs under an allowlist that passes only that provider's own credentials. `ANTHROPIC_API_KEY` never reaches Codex; `OPENAI_API_KEY` never reaches Claude; and unrelated secrets (`GITHUB_TOKEN`, `COMPOSER_AUTH`, the ssh-agent socket, CI tokens) never reach any AI CLI. Detection probes run with no credentials at all.
- **Pluggable adapters.** [Adding Groq, Ollama, or your own AI →](https://tessera-ai.net/docs/architecture/adapter-system)

Quick reference — CLI commands
------------------------------

[](#quick-reference--cli-commands)

```
tessera doctor                                       # is my system ready?
tessera new                                     # the main command
tessera new  --force                            # overwrite existing dir
tessera new  --stack=                     # skip AI stack selection
tessera new  --requirements-fixture=      # skip interactive Q&A (loads JSON)
tessera plan compile  [-o ]          # compile manifest → plan.json
tessera plan show []                      # pretty-print a plan
tessera plan diff                    # semantic diff (exit 0/1/2)
tessera tools                                        # which AI tools are installed?
tessera --version
tessera --help
```

[Full CLI reference on the docs site →](https://tessera-ai.net/docs/cli/plan)

Environment variables
---------------------

[](#environment-variables)

Optional. The installer asks interactively if not set.

```
TESSERA_CLAUDE_PLAN=max       # max | pro | free
TESSERA_CODEX_PLAN=plus       # plus | free
TESSERA_GEMINI_PLAN=free      # pro | free
TESSERA_TOOL_PREFERENCE=gemini,claude,codex   # custom tool order
TESSERA_TOOL_EXCLUDE=codex                    # never use this tool
TESSERA_SAFE_AI=1             # opt out of --dangerously-skip-permissions for Claude
TESSERA_AI_TIMEOUT=900        # seconds per AI step (default 900)
```

[Full security &amp; permission model →](https://tessera-ai.net/docs/disclaimer)

After the build
---------------

[](#after-the-build)

```
cd my-restaurant
cat SETUP.md              # what to configure (env vars, API keys, deploy)
php artisan serve          # for Laravel — npm run dev for static/node, etc.
```

Each stack's `SETUP.md` is junior-developer-friendly: env keys with the URL where to get them, payment provider step-by-step, deployment checklist. AI writes it as part of the build.

For continuing changes:

- **Laravel** — `php artisan tessera "add a gallery to the homepage"` (in-project AI Engine with project context).
- **Other stacks** — use your AI CLI directly: `claude "add JWT auth"` / `codex "create REST endpoints"` / `gemini "add a dark mode toggle"`. The AI reads your codebase and knows the structure.

Testing
-------

[](#testing)

```
vendor/bin/phpunit
```

477 tests, 1090 assertions — all passing with zero AI tokens. CI runs on Ubuntu, Windows, and macOS with PHP 8.4–8.5.

Contributing &amp; adding a stack
---------------------------------

[](#contributing--adding-a-stack)

[Contributing guide →](https://tessera-ai.net/docs/contributing) · [How to author a stack →](https://tessera-ai.net/docs/architecture/yaml-manifests)

The minimal recipe: drop `stacks/.yaml`, add a `*Stack.php` lifecycle class with `preflight()` / `postSetup()` / `completionInfo()`, register in `StackRegistry`. The YAML drives the AI portion; the PHP class only handles tool-specific lifecycle.

Disclaimer
----------

[](#disclaimer)

**AI Token Usage.** Tessera calls AI CLI tools installed on your system. Each call consumes tokens from your own subscription plan or API quota. Tessera does not provide, manage, or pay for AI access. A typical project build uses 5–10 AI calls.

**Generated Code.** AI-generated code may contain bugs, security vulnerabilities, incorrect business logic, or incompatible dependencies. Tessera includes safeguards (quality gates, PHP lint, test loops, namespace verification), but you are responsible for reviewing, testing, and validating all generated code before production.

**Third-Party Services.** Tessera may scaffold integrations with third-party services (payment providers, cloud APIs, email services). These integrations need manual configuration and validation. Tessera is not affiliated with and makes no guarantees about any third-party service.

**No Warranty.** This software is provided "as is", without warranty of any kind. The authors are not liable for damages arising from the use of this software or any code it generates. Use at your own risk.

[Full disclaimer →](https://tessera-ai.net/docs/disclaimer)

License
-------

[](#license)

Tessera is **source-available**, not open source.

Use caseCostLicencePersonal projects, learning, OSS, non-profit, government**Free**[PolyForm Noncommercial 1.0.0](LICENSE.md)Client work for pay (agency / freelance)from **€249/yr**Commercial — SoloAgency / small product team (up to 10 devs)**€799/yr**Commercial — StudioLarger teams, custom SLA, private registry**Custom**Commercial — Enterprise**Generated code is yours** in either lane — the licence covers the installer itself, not the projects it scaffolds.

- [Pricing &amp; buy a commercial licence →](https://tessera-ai.net/docs/pricing)
- [Full Commercial License Agreement →](https://tessera-ai.net/docs/commercial-license)
- [Licence overview &amp; FAQ →](https://tessera-ai.net/docs/license)

###  Health Score

46

—

FairBetter than 92% of packages

Maintenance95

Actively maintained with recent releases

Popularity7

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity63

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~2 days

Total

32

Last Release

24d ago

Major Versions

v1.3.0 → v2.0.02026-03-13

v2.9.0 → v3.0.02026-03-14

PHP version history (2 changes)v1.0.0PHP ^8.2

v3.11.1PHP ^8.4

### Community

Maintainers

![](https://www.gravatar.com/avatar/27d71933a44feff8905b90da6867281d8bf6b88e4fe2b94f85c4483687f4ad59?d=identicon)[drnasin](/maintainers/drnasin)

---

Top Contributors

[![drnasin](https://avatars.githubusercontent.com/u/3784166?v=4)](https://github.com/drnasin "drnasin (89 commits)")

---

Tags

laravelaiinstallercmstessera

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/tessera-installer/health.svg)

```
[![Health](https://phpackages.com/badges/tessera-installer/health.svg)](https://phpackages.com/packages/tessera-installer)
```

###  Alternatives

[statamic/cms

The Statamic CMS Core Package

4.8k3.5M916](/packages/statamic-cms)[craftcms/cms

Craft CMS

3.6k3.6M2.9k](/packages/craftcms-cms)[n98/magerun2

Tools for managing Magento projects and installations

927245.1k6](/packages/n98-magerun2)[rcsofttech/audit-trail-bundle

Enterprise-grade, high-performance Symfony audit trail bundle. Automatically track Doctrine entity changes with split-phase architecture, multiple transports (HTTP, Queue, Doctrine), and sensitive data masking.

1155.2k](/packages/rcsofttech-audit-trail-bundle)[joshembling/laragenie

An AI bot made for the command line that can read and understand any codebase from your Laravel app.

1499.8k](/packages/joshembling-laragenie)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
