Make AI coding reliable at team scale.
A team AI coding harness for progressive specs, custom workflows, task context, and memory across Claude Code, Cursor, Codex, OpenCode, Pi Agent, and more.
简体中文 • Docs • Quick Start • Supported Platforms • Use Cases
Trellis is a built-in AI coding harness for teams. It turns the huge system prompt you would normally put in CLAUDE.md, AGENTS.md, or .cursorrules into a progressive wiki of specs, tasks, workflows, and journals that agents load only when needed.
It gives Claude Code, Cursor, Codex, OpenCode, Pi Agent, and other agents the same project source of truth: team standards, task decisions, runbooks, and session memory, without stuffing the whole codebase into every prompt. Trellis is used by individual builders, open-source maintainers, teams inside tech giants, top university labs, and public-company engineering departments working on production monorepos with hundreds of thousands of lines of code.
Trellis installs a .trellis/ directory into your repository and generates the right entry points for each AI coding platform you use.
| Layer | Purpose |
|---|---|
.trellis/spec/ |
Team standards and coding guidelines that agents can load automatically. |
.trellis/tasks/ |
PRDs, task context, status, review notes, and acceptance criteria. |
.trellis/workspace/ |
Developer-level journals, decisions, and handoff notes for session continuity. |
.trellis/workflow.md |
The shared lifecycle for planning, building, checking, finishing, and learning. |
| Platform adapters | Generated commands, hooks, skills, prompts, workflows, and agent files for your tools. |
The core loop is short:
- Capture the task as a PRD.
- Inject the relevant project specs.
- Let the agent implement inside a clear boundary.
- Run checks before handoff.
- Promote reusable lessons back into specs.
- Record the session so the next agent starts with the decisions and context it needs.
For the deeper product model, see the docs and real-world scenarios.
Prerequisites:
- Node.js >= 18
- Python >= 3.9 for hooks and automation scripts
Install Trellis:
npm install -g @mindfoldhq/trellis@betaInitialize a repository:
# Start Trellis and create a developer workspace
trellis init -u your-nameSee the Quick Start and Supported Platforms guides for setup details.
Trellis 0.5 is skill-first. On hook-capable or extension-capable platforms, session context loads automatically. On platforms that need a manual entry point, start with:
/start or /trellis:start # Load project context
Then describe the task in natural language. Trellis routes the work through skills for brainstorming, spec loading, implementation checks, and knowledge capture. Use continue to advance the current task and finish-work after human testing and commit.
| Need | Link |
|---|---|
| Install Trellis in a repo | Quick Start |
| Understand platform differences | Supported Platforms |
| See the workflow in practice | Real-World Scenarios |
| Start from spec templates | Spec Templates |
| Track releases | Changelog |
How is Trellis different from CLAUDE.md, AGENTS.md, or .cursorrules?
Those files are useful entry points, but they tend to become monolithic. Trellis adds scoped specs, task PRDs, workflow gates, workspace memory, and platform-aware generated files around them.
Is Trellis only for Claude Code?
No. Trellis is a project layer that works across multiple coding agents and IDEs.
Is Trellis for solo developers or teams?
Both. Solo developers use it for memory and repeatable workflow. Teams get the larger benefit: shared standards, task boundaries, reviewable context, and platform portability.
Official Repository • AGPL-3.0 License • Built by Mindfold