Child agent controls
| Flag | Type | Default | Description |
|---|
--help, -h | boolean | | Show help for the current command |
--version | boolean | | Show the version number for the CLI |
List child agents for a session
| Flag | Type | Default | Description |
|---|
--help, -h | boolean | | Show help for the current command |
--version | boolean | | Show the version number for the CLI |
--session, -s | string | | Session ID (auto-detects from cwd if omitted) |
Delegate work to a child agent
polygraph agent spawn [repo] [instruction]
| Name | Type | Description |
|---|
repo | string | Repository (ID, full name, or short name) |
instruction | string | Instruction to execute |
| Flag | Type | Default | Description |
|---|
--help, -h | boolean | | Show help for the current command |
--version | boolean | | Show the version number for the CLI |
--session, -s | string | | Session ID (auto-detects from cwd if omitted) |
--context | string | | Additional context for the delegated task |
--agent | "claude"|"opencode"|"codex" | | Agent runtime to use |
Show child agent status
polygraph agent show [repo]
| Name | Type | Description |
|---|
repo | string | Repository (ID, full name, or short name) |
| Flag | Type | Default | Description |
|---|
--help, -h | boolean | | Show help for the current command |
--version | boolean | | Show the version number for the CLI |
--session, -s | string | | Session ID (auto-detects from cwd if omitted) |
--tail | number | | Number of trailing log lines to include |
Attach a TUI to a child agent
polygraph agent attach [session]
| Name | Type | Description |
|---|
session | string | Session ID (auto-detects from cwd if omitted) |
| Flag | Type | Default | Description |
|---|
--help, -h | boolean | | Show help for the current command |
--version | boolean | | Show the version number for the CLI |
--repo, -r | string | | Repository (ID, full name, or short name) - optional; the picker resolves it when omitted. |
Stop a child agent
polygraph agent stop [repo]
| Name | Type | Description |
|---|
repo | string | Repository (ID, full name, or short name) |
| Flag | Type | Default | Description |
|---|
--help, -h | boolean | | Show help for the current command |
--version | boolean | | Show the version number for the CLI |
--session, -s | string | | Session ID (auto-detects from cwd if omitted) |