CLI Reference

terso init

Initialize Terso in a project directory.

terso init

Creates .terso/ directory with template files. Interactive setup prompts for API endpoint and project detection.

terso capture

Capture knowledge from the terminal.

terso capture "your text here"

Output:

ingestionId: ing_abc123
status: queued

terso auth

Manage API authentication.

terso auth set <token>   # save API token
terso auth status        # show auth status
terso auth clear         # remove stored token

Tokens are stored in ~/.terso/config.json. Override with TERSO_API_TOKEN env var.

terso sync

Pull context from Omnus and write to .terso/generated/.

terso sync
terso sync --force
terso sync --dry-run

Options:

• --force -- overwrite even if fresh
• --dry-run -- preview without writing

terso search

Quick search from the terminal.

terso search "stripe webhook setup"

Returns top 3 results with source links and freshness indicators.

terso status

Show current project knowledge status.

terso status

terso doctor

Check project health and configuration.

terso doctor

Verifies: .git exists, .terso/config.json present, API connectivity, stale context warnings.

terso watch

Watch for file changes and auto-capture significant changes.

terso watch

terso compile

Compile raw local captures into structured context (works offline).

terso compile

Reads from .terso/local/captures.jsonl, organizes into structured Markdown, and writes to .terso/generated/.