Command Reference

trellis init [--path <dir>]            # Initialize a new repo
trellis import --from <git-repo>       # Import Git history as milestones
trellis export --to <dir>              # Export milestones to Git commits

trellis status                          # Current branch, op count, pending changes
trellis log [--limit N] [--branch b]    # Op stream history
trellis files [--deleted]               # All tracked files
trellis watch                           # Start continuous file watching

trellis branch                          # List branches
trellis branch <name>                   # Create + switch to branch
trellis branch -d <name>               # Delete a branch

trellis milestone create -m "message"                          # Create milestone
trellis milestone create -m "msg" --from <hash> --to <hash>   # Over a specific range
trellis milestone list                                          # List milestones
trellis checkpoint create                                       # Manual checkpoint
trellis checkpoint list                                         # List checkpoints

trellis diff [--from <hash>] [--to <hash>]  # File-level diff
trellis merge --branch <name> [--dry-run]   # Three-way merge
trellis parse <file>                        # Semantic parse (declarations, imports)
trellis sdiff <fileA> <fileB>               # Semantic diff between two versions

trellis identity [show|create|list]         # Manage identities

trellis garden                                        # List abandoned clusters
trellis garden list [--status <s>] [--file <f>]      # Filter clusters
trellis garden show <cluster-id>                      # Inspect a cluster
trellis garden search --keyword <term>                # Search by keyword
trellis garden revive <cluster-id>                    # Revive cluster as branch
trellis garden stats                                  # Garden statistics

trellis issue create -t "Title" -P high -l label      # Create issue
trellis issue list [--status <s>]                      # List/filter issues
trellis issue active                                   # Currently active issues
trellis issue triage TRL-1                             # Move backlog → open
trellis issue start TRL-1                              # Start (auto-branch)
trellis issue pause TRL-1                              # Pause
trellis issue resume TRL-1                             # Resume
trellis issue update TRL-1 [options]                   # Update metadata
trellis issue describe TRL-1 "description"             # Set description
trellis issue check TRL-1                              # Run acceptance criteria
trellis issue close TRL-1 --confirm                    # Close issue

trellis entity create -i <id> -t <type> -a key=value      # Create entity
trellis entity get <id> [--json]                          # Get entity details
trellis entity update <id> -a key=value                   # Update attributes
trellis entity delete <id>                                # Delete entity
trellis entity list [-t <type>]                          # List entities
trellis entity fact add <id> -a key=value                 # Add fact
trellis entity fact remove <id> -a key                    # Remove fact
trellis entity link add <id> -r <target> -a key          # Add link
trellis entity link remove <id> -r <target> -a key       # Remove link

trellis decision list [--tool <pattern>]               # List decisions
trellis decision show DEC-1                            # Show full trace
trellis decision chain issue:TRL-5                     # Decision chain for entity

trellis sync status                       # Local sync state
trellis sync reconcile --remote <path>    # Reconcile with another repo
trellis sync push --peer <id>             # Push ops to a peer (coming soon)
trellis sync pull --peer <id>             # Pull ops from a peer (coming soon)

trellis db query <eql>                     # EQL-S query
trellis ask "authentication code"                       # Semantic search
trellis ask "show me auth code" --rag                  # RAG context output

trellis ontology list                     # List ontologies
trellis ontology show <id>                # Show details
trellis ontology validate                 # Validate store