Run gdm --help for a quick summary. Each subcommand also accepts --help.
gdm [OPTIONS] [PROMPT]
Starts the coding agent REPL. If no subcommand is given, gdm code is invoked.
gdm version
Show installed version and provider status.
gdm health [--json]
Live system health check. Tests the database, background daemon, API connectivity, tool availability, and budget state.
| Flag | Description |
|---|---|
--json |
Output results as JSON (useful for CI pipelines) |
gdm doctor
Check environment, installed dependencies, and configuration. Prints warnings for any missing optional dependencies (Playwright, Whisper, etc.).
gdm login [PROVIDER]
Authenticate with an AI provider and store credentials in the OS keychain.
| Argument | Values | Default |
|---|---|---|
PROVIDER |
grok, gemini, codex, all |
all |
gdm logout [PROVIDER]
Remove stored credentials for a provider, proxy, or all routes.
| Argument | Values | Default |
|---|---|---|
PROVIDER |
grok, gemini, codex, proxy, all |
all |
gdm code [OPTIONS]
Start the coding agent REPL (explicit invocation).
| Flag | Description |
|---|---|
--yes / -y |
Bypass all permission prompts for this session |
--provider TEXT |
Force provider: grok, gemini, codex |
--model TEXT |
Override model tier: scout, coder, thinker, reasoner, debate |
--max-turns INT |
Override max_turns for this session |
--cost-limit FLOAT |
Override session cost cap in USD |
--prompt / -p TEXT |
Non-interactive: run one prompt and exit |
gdm review [--pr N] [--post-comment]
Run gdm review on a pull request (read-only analysis).
| Flag | Description |
|---|---|
--pr N |
PR number to review (required) |
--post-comment |
Post review result as a PR comment (requires GITHUB_TOKEN) |
gdm mcp [TRANSPORT]
Start gdm as an MCP server (Model Context Protocol). Exposes gdm tools to MCP-compatible clients such as Claude Desktop. Reads JSON-RPC 2.0 from stdin, writes to stdout.
| Argument | Values | Default |
|---|---|---|
TRANSPORT |
stdio |
stdio |
gdm voice [MODE] [--stt PROVIDER] [--tts PROVIDER]
Start voice interaction with the coding agent.
| Argument/Flag | Values | Default | Description |
|---|---|---|---|
MODE |
ptt, stream |
ptt |
ptt = push-to-talk; stream = continuous listening |
--stt |
whisper, … |
whisper |
Speech-to-text provider |
--tts |
pyttsx3, … |
pyttsx3 |
Text-to-speech provider |
gdm browser [ACTION] [--port INT]
Manage the gdm bridge server for Chrome extension / browser automation.
| Argument | Values | Default | Description |
|---|---|---|---|
ACTION |
start, stop, status |
status |
Lifecycle action |
--port |
integer | 9321 |
Bridge listen port |
gdm remote [ACTION] [--port INT]
Manage the remote tunnel for phone-based agent control.
| Argument | Values | Default | Description |
|---|---|---|---|
ACTION |
start, stop, status, qr |
status |
Lifecycle action |
--port |
integer | 8765 |
Local port to expose |
gdm remote start prints a URL and QR code. Scan with a mobile browser to open the phone UI.
gdm daemon [ACTION]
Manage the gdm background daemon (code indexing, session compression, security scanning).
| Argument | Values | Default |
|---|---|---|
ACTION |
start, stop, status |
status |