Trellis CLI

Install

Works in

• Claude Code
• Cursor
• Codex
• OpenCode
• GitHub Copilot
• Gemini CLI
• Kiro
• Google Antigravity

npx skillfoxx add cli/trellis

What it does

Trellis installs from npm with `npm install -g @mindfoldhq/trellis@latest`; then `trellis init` in the repository root creates a `.trellis/` folder and files for the agents you pick. `.trellis/spec/` holds project rules, `.trellis/tasks/` holds tasks with their requirements and the context for implementation and review, and `.trellis/workspace/` holds each developer's personal session journals. For Claude Code, Cursor, Codex, OpenCode and 18 more platforms the command adds commands, skills, subagents and hooks, and flags such as `--cursor` and `--codex` narrow the list. Work runs in four phases. The `trellis-brainstorm` skill asks one question at a time until the requirements are clear and writes `prd.md`; it does not move on to implementation until the user has replied at least once. The `trellis-implement` subagent writes the code, taking the relevant rules from `implement.jsonl` and `check.jsonl`. The `trellis-check` subagent compares the changes with the specs, runs lint, type checks and tests, and fixes what it finds. `/trellis:finish-work` archives the task and appends to the journal, and `trellis-update-spec` moves new lessons back into `.trellis/spec/`. In Claude Code, python3 hooks fire on session start, clear and compact and before a subagent launches, to inject context. Utility commands sit alongside: `trellis mem` searches conversation history across Claude Code, Codex, OpenCode and Pi, `trellis channel` runs worker agents as separate local processes with an event log, and `trellis update` refreshes the files after a new release.

Who it is for. For developers and teams who use several AI agents in one repository and want rules, tasks and session memory stored next to the code.

Example request

I want to add PDF report export to the project. Start with brainstorming, ask questions one at a time and move to code only after I agree

Limitations

The license is AGPL-3.0. Node.js 18 or newer and Python 3.9 or newer are required.

• The scripts commit journals and the task archive to git on their own. To turn this off, set `session_auto_commit: false` in `.trellis/config.yaml`.
• The `.trellis` folder can hold sensitive task and spec text. `trellis ablate` stores a copy of its contents outside the project and keeps it until `trellis restore` succeeds.
• If a file managed by Trellis changes while the project is ablated, `trellis restore` refuses to write until you resolve the conflict.
• The set of files depends on the platform: Copilot gets hooks, Pi and Oh My Pi get extensions, the rest get commands or skills. `trellis platforms` prints the full list.
• The version is 0.x: file formats change through migrations, and `trellis update --migrate` applies them.

How to disable. The `TRELLIS_HOOKS=0` variable disables only the hooks. `trellis ablate` temporarily removes all Trellis files from the project for a comparison, and `trellis restore` brings the earlier state back. `trellis uninstall` deletes the platform files and `.trellis/` for good; run it with `--dry-run` first to see the list.

README in short

The description comes in English and Chinese. It opens with a capability table, followed by the requirements, three quick-start commands and four working steps. After that come a diagram of the four-phase loop, a table of links to the docs at docs.trytrellis.app and a question section covering how it differs from rules files and how to turn Trellis off temporarily. Beside the package the repository holds Trellis's own project with its own specs and tasks, a vitest test suite and a log of migrations by version.