CLI Overview
The Trellis command-line interface your primary operational surface for repository management and automation.
Installation
npm install -g trellis
trellis -h
Philosophy
The CLI is the fastest way to initialize repos, inspect history, create milestones, diff/merge work, and script automation around the op stream. It exposes the shipped repository, graph, query, and local Studio surfaces; agent harness and standalone MCP commands are tracked on the roadmap until they ship as CLI entry points.
Common Options
trellis --help # Show top-level help
trellis --version # Show version
trellis status -p <dir> # Most repo commands accept -p/--path
Command Groups
| Group | Purpose |
|---|---|
| Setup: | init, seed, repair, import, export |
| Working: | status, log, files, watch, branch |
| History: | milestone, checkpoint |
| Diff: | diff, merge, parse, sdiff |
| Identity | identity |
| Garden: | garden list, garden search, garden revive |
| Issues: | issue create, issue start, issue close, … |
| Lanes: | lane create, lane watch, lane promote, … |
| Git: | git sync (commit working tree → git; 4.0+) |
| Test: | test (.trellis/tests.json suites) |
| Protocol: | protocol send, whereami |
| Refs: | refs, refs --backlinks |
| Sync: | sync status, sync reconcile |
| Entity: | entity create, entity get, entity list |
| Query: | query, ask, search, db query |
| Studio: | studio (launch Trellis Studio) |
| Database | db init, db serve, db deploy |
| System: | ontology |
See the full command reference for details on every command.