Agent The `hanzo agent` commands.
Also for this capability: API · CLI · MCP · SDKs
Autonomous agents for your org: define them, run them, keep every run.
API reference →
Every command takes --json for the raw response and --help for its own flags. Sign in once with hanzo auth login; the commands below use that session, and the org they act in is the one it carries.
Command What it does hanzo agent activityServes the org-wide recent-activity feed. hanzo agent codingStart one autonomous coding run against a repo in the caller's org hanzo agent createDefines an agent in the caller's org: a model, a system prompt (instructions) and a set of tool names. hanzo agent listReturns every agent defined in the caller's org, each with the number of runs recorded against it. hanzo agent metricsServes the invocations-over-time histogram for the org's Agents dashboard. hanzo agent runs-allReturns the org's agent runs across EVERY agent, newest first — what ran here, for whom, on which model, how long it…
Command What it does hanzo agent builds listReturns the public index of every published build, most recently updated first, so a gallery can link straight to the… hanzo agent builds org get <org> <project>Returns the readable build of one product: the agent session that produced it, turn by turn — the prompts, the…
Command What it does hanzo agent chat conversations createRecord turns in a conversation hanzo agent chat conversations get <id>Read one agent thread in full hanzo agent chat conversations listList the agent threads in your org hanzo agent chat createRun one tool-calling round against your org's own tools hanzo agent chat presetsList the agent presets available to a caller
Command What it does hanzo agent get <ref>Returns one agent with its system prompt and its 20 most recent runs.
Command What it does hanzo agent rm <ref>Removes an agent and every run recorded against it.
Command What it does hanzo agent run <ref>Run one of your org's agents and get the recorded run back.
Command What it does hanzo agent runs <ref>Returns one agent's execution history, newest first — each run's input, its output or its error, and how long it took.
Command What it does hanzo agent sessions budget <id>Sets, raises, or removes a session's cap. hanzo agent sessions control <id>Returns the steering commands (pause/resume/stop/message) recorded against the caller's own session that are newer than… hanzo agent sessions createOpens a live agent session in the caller's org — the row every surface (the CLI's outer agent, hanzo.bot, the console,… hanzo agent sessions events <id>Records one turn of a session's transcript and answers 201 with it. hanzo agent sessions get <id>Returns one session with its direct child sessions and its 50 most recent events, oldest of those first. hanzo agent sessions listReturns the caller org's live sessions, newest first — each with its event count, its direct-child count and a one-line… hanzo agent sessions message <id>Sends a steering message to a running session — the endpoint a human or another agent interrupts through. hanzo agent sessions pause <id>Asks a running session to pause. hanzo agent sessions progress <id>Returns how far along one run is: the share of its goal that is done, whether it is running, blocked or finished, and a… hanzo agent sessions resume <id>Asks a paused session to continue, on the same terms as a pause. hanzo agent sessions stop <id>Ends a running session. hanzo agent sessions streamLive session and event updates for the caller's org, as Server-Sent Events. hanzo agent sessions tree <id>Returns the subagent-flow graph rooted at this session: the session, its children, their children, each node carrying… hanzo agent sessions update <id>Updates a session's surface-owned truth: its status, its title, the run-target it is dispatched to, and the product it…
Command What it does hanzo agent spend <ref>Answers what one of your org's agents has spent, in integer micro-USD.
Command What it does hanzo agent targets claim <id>ClaimRoutedRun is the machine's long poll for work: it authenticates the daemon, stamps the liveness the dispatch gate… hanzo agent targets createRegisters a machine as an agent target, or re-links one that is already registered. hanzo agent targets get <id>Returns one registered machine, with its live session load. hanzo agent targets key <id>Mints (or rotates) the claim key a hanzo code --serve daemon presents to claim work for this machine, and returns it… hanzo agent targets listReturns every machine registered to the caller's org, newest first, each with its live session load. hanzo agent targets rm <id>Deregisters one machine. hanzo agent targets runs report <id> <runId>Completes a claimed run: it delivers the terminal result to the run's durable owner, which is what lets that workflow… hanzo agent targets update <id>Updates one machine in place.
Command What it does hanzo agent update <ref>Changes an agent in place.
How is this guide?