ctx_agent Memory & Multi-Agent Multi-agent coordination (shared message bus + persistent diaries). Actions: register (join with agent_type+role), post (broadcast or direct message with category), read (poll messages), status (update state: active|idle|finished), handoff (transfer task to another agent with summary), sync (overview of all agents + pending messages + shared contexts), diary (log discovery/decision/blocker/progress/insight — persisted across sessions), recall_diary (read agent diary), diaries (list all agent diaries), list, info.
✓ When to Use
Multi-agent workflows where multiple AI editors need to coordinate, share findings, or hand off tasks.
✗ When Not to Use
Single-agent sessions where you're the only AI working on the project.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
action | "register" | "list" | "post" | "read" | "status" | "info" | "handoff" | "sync" | "diary" | "recall_diary" | "diaries" | "share_knowledge" | "receive_knowledge" | Yes | Agent operation. diary: persistent log. share_knowledge: broadcast key=value facts (message: 'k1=v1;k2=v2'). receive_knowledge: poll shared facts from other agents. |
agent_type | string | No | Agent type for register (cursor, claude, codex, gemini, crush, subagent) |
category | string | No | Message category for post (finding, warning, request, status) |
message | string | No | Message text for post action, or status detail for status action |
role | string | No | Agent role (dev, review, test, plan) |
status | "active" | "idle" | "finished" | No | New status for status action |
to_agent | string | No | Target agent ID for direct message (omit for broadcast) |
Actions
register ctx_agent action="register"
list ctx_agent action="list"
post ctx_agent action="post"
read ctx_agent action="read"
status ctx_agent action="status"
info ctx_agent action="info"
handoff ctx_agent action="handoff"
sync ctx_agent action="sync"
diary ctx_agent action="diary"
recall_diary ctx_agent action="recall_diary"
diaries ctx_agent action="diaries"
share_knowledge ctx_agent action="share_knowledge"
receive_knowledge ctx_agent action="receive_knowledge"
Related Tools
8e5656acf265ba8edbb16467198fea7f ← Back to all tools