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, … |
| 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.