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) |
Grant a child agent's pending permission-required request
polygraph agent allow [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) |
--repo, -r | string | | Repository (ID, full name, or short name) |
--scope | string | one-time | Permission scope. "one-time" applies to this single request; "session" is remembered for equivalent later requests within the child's session. |
--reason | string | | Optional reason for allowing the request |
Deny a child agent's pending permission-required request
polygraph agent deny [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) |
--repo, -r | string | | Repository (ID, full name, or short name) |
--reason | string | | Optional reason for denying the request |
Stream a session's child permission-gate transitions as NDJSON (machine-only)
| 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) |
--follow | boolean | false | Keep the stream open and emit new events as they happen |
