Reference
Run gdm --help for a quick summary. Each subcommand also accepts --help.
Starts the interactive REPL. If a prompt is given, runs one turn then returns to the prompt. gdm code is an alias.
| Flag | Description |
|---|---|
| --prompt TEXT | Task description (skips interactive input) |
| --yes | Auto-approve all tool calls (non-interactive) |
| --model TEXT | Override model tier: scout, coder, thinker, reasoner, debate |
Show installed version and configured API providers.
Live system health check — database, daemon, API connectivity, tool availability, and budget state.
| Flag | Description |
|---|---|
| --json | Output results as JSON (useful for CI) |
Store an API key in the OS keychain. Supported providers: grok, gemini, codex.
Show spending summary grouped by provider and model tier.
Available inside the interactive REPL:
| Command | Description |
|---|---|
| /model [TIER] | Switch model tier (interactive picker if no arg) |
| /cost | Show session cost |
| /status | Agent and session status |
| /tasks | List in-progress tasks |
| /btw NOTE | Queue a note for the next session |
| /diff | Show pending git diff |
| /commit | Commit staged changes |
| /branch NAME | Create and switch to a new branch |
| /pr | Open a GitHub pull request |
| /compact | Summarise and compress conversation context |
| /clear | Clear the screen |
| /update | Check for and install the latest version |
| /exit, /quit | Exit the REPL |