CLI overview
Every top-level command in grith, what it does, and where to find more.
grith is the single binary that fronts the whole platform. With no arguments it drops
into an interactive REPL; otherwise the first positional is a subcommand.
grith <command> [options...]
Global flags
| Flag | What it does |
|---|---|
--config <path> | Override the config file location. |
--log-level <level> | One of trace, debug, info, warn, error. |
--no-color | Disable ANSI colour in output. Useful for piping. |
--project <name> | Override the project name (defaults to the current directory). |
Commands
| Command | What it does |
|---|---|
| grith run | Execute a single task non-interactively |
| grith init | Create default configuration |
| grith config | Show or modify configuration |
| grith audit | Browse audit logs |
| grith digest | Manage digest queue |
| grith canary | Manage canary tokens used for exfiltration trap detection |
| grith proxy | Security proxy commands |
| grith exec | Supervise an external CLI tool with OS-level syscall interception |
| grith supervisor | List or manage active supervisor sessions |
| grith daemon | Manage the grith daemon (dashboard server + shared subsystems) |
| grith pro | Manage Pro plan: login, status, sync, activate, logout |
| grith notifications | Manage notification channels |
| grith log | View audit-backed session logs |
| grith profile | Manage supervisor profiles |
| grith reputation | Manage the reputation system |
Top-level command listing only. Per-command flag detail is rendered on the individual command pages.
How to read this reference
- Commands are documented one-per-page. Click through from the sidebar.
- Subcommands appear on the parent command's page (e.g.
grith canary add,grith canary removeare documented under grith canary). - Exit codes are 0 for success, 1 for queue, 2 for deny in proxy-style commands; generic non-zero for other failures.
Where do I start?
Most readers want one of these three:
- First-time setup — run
grith init, then point it at an agent withgrith exec. - Reviewing decisions — see
grith digestandgrith log. - Operating the daemon — see
grith daemon.
ℹ️Generated from clap
The command list above is regenerated from the clap definitions in
crates/grith-core/src/main.rs whenever npm run gen:references runs in the docs
repo. If you add a new top-level command in grith, it will appear here automatically
on the next regeneration.
Last updated: 2026-05-14Edit this page on GitHub →