agent_status
Idempotent
Retrieve detailed status for a named agent, including terminal tail and optional injected brief, to monitor running workers and diagnose progress.
Instructions
Detailed status for one agent, addressed by name (or agent_id), including a short tail of its terminal. include_brief=true returns the exact brief this worker was given; hive keeps that copy because an appended system prompt appears in no transcript.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "agent_status"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | The worker's name, e.g. "impl" or "DEVX-123". Prefer passing this rather than agent_id, but pass only one: if both arrive, agent_id wins and this is ignored. A partial name works when it matches exactly one running worker, so "123" finds DEVX-123. | |
| agent_id | No | Numeric agent id. Use name instead unless you have the id to hand. | |
| project_id | No | Different project override. Use ONLY when the user explicitly asks for another project by name; otherwise stay in the current scope, even when results are empty. | |
| include_brief | No | Return the full injected brief, not just its path. Defaults to false. |