Agents The `hanzo agents` 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 agents activityServes the org-wide recent-activity feed. hanzo agents codingStart one autonomous coding run against a repo in the caller's org hanzo agents createDefines an agent in the caller's org: a model, a system prompt (instructions) and a set of tool names. hanzo agents listReturns every agent defined in the caller's org, each with the number of runs recorded against it. hanzo agents metricsServes the invocations-over-time histogram for the org's Agents dashboard. hanzo agents 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 agents builds listReturns the public index of every published build, most recently updated first, so a gallery can link straight to the… hanzo agents 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 agents chat conversations get <id>Read one agent thread in full hanzo agents chat conversations listList the agent threads in your org hanzo agents chat createRun one tool-calling round against your org's own tools hanzo agents chat presetsList the agent presets available to a caller
Command What it does hanzo agents get <ref>Returns one agent with its system prompt and its 20 most recent runs.
Command What it does hanzo agents rm <ref>Removes an agent and every run recorded against it.
Command What it does hanzo agents run <ref>Run one of your org's agents and get the recorded run back.
Command What it does hanzo agents 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 agents sessions control <id>Returns the steering commands (pause/resume/stop/message) recorded against the caller's own session that are newer than… hanzo agents 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 agents sessions events <id>Records one turn of a session's transcript and answers 201 with it. hanzo agents sessions get <id>Returns one session with its direct child sessions and its 50 most recent events, oldest of those first. hanzo agents sessions listReturns the caller org's live sessions, newest first — each with its event count, its direct-child count and a one-line… hanzo agents sessions message <id>Sends a steering message to a running session — the endpoint a human or another agent interrupts through. hanzo agents sessions pause <id>Asks a running session to pause. hanzo agents 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 agents sessions resume <id>Asks a paused session to continue, on the same terms as a pause. hanzo agents sessions stop <id>Ends a running session. hanzo agents sessions streamLive session and event updates for the caller's org, as Server-Sent Events. hanzo agents sessions tree <id>Returns the subagent-flow graph rooted at this session: the session, its children, their children, each node carrying… hanzo agents 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 agents targets claim <id>ClaimRoutedRun is the machine's long poll for work: it authenticates the daemon, stamps the liveness the dispatch gate… hanzo agents targets createRegisters a machine as an agent target, or re-links one that is already registered. hanzo agents targets get <id>Returns one registered machine, with its live session load. hanzo agents 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 agents targets listReturns every machine registered to the caller's org, newest first, each with its live session load. hanzo agents targets rm <id>Deregisters one machine. hanzo agents 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 agents targets update <id>Updates one machine in place.
Command What it does hanzo agents update <ref>Changes an agent in place.
How is this guide?