Durable local messaging and coordination for Claude Code and Codex agents
14 tools with complete input schemas and descriptions, but quality is uneven. Most descriptions are terse (10-50 chars), below the 50-200 char baseline for LLM optimization. Parameter descriptions are minimal or absent in many cases. No output schemas documented. Error handling and recovery guidance missing. Tools like send_mail, claim_path, and work_acquire lack sufficient context for LLM selection. Naming is verb-first and clear, but descriptions do not explain WHEN to use each tool or what it returns.
List messages in the inbox for this session
Claim exclusive access to a file or directory for coordination
Claim and retrieve an experiment number for coordination
List all active claims in the project
List all live sessions in the project with their status and capabilities
List all active work leases in the project
Mark messages as read for this session
Descriptions are too terse (10-50 chars vs. 50-200 char baseline). Most lack WHEN/WHY context for LLM selection. E.g., 'Claim exclusive access to a file or directory for coordination' does not explain when to use claim_path vs. work_acquire or what happens on conflict.
No output schemas documented. LLMs cannot plan downstream calls or extract required fields. E.g., list_sessions returns 'status and capabilities' but structure is unknown. send_mail returns nothing documented.
Parameter descriptions are minimal or missing context. E.g., 'to' in send_mail says 'Session name, id, or all' but does not explain how to obtain a session name or what happens if the session is not found.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 59 | 2026-07-28+ | v2 |
Pause channel push notifications for this session (mail continues to spool)
Release a previously claimed path
Send a message to one or more sessions in the project
Resume channel push notifications for this session
Acquire an exclusive work lease for a type and key
Release an active work lease
Update the state of an active work lease
No error handling or recovery guidance. Tools do not document what errors are possible, whether they are retryable, or what the LLM should do next. E.g., claim_path may fail on conflict but no guidance is provided.
Coordination tools (claim_path, work_acquire, experiment_number) lack clear distinction. Descriptions do not explain when to use each or how they interact. LLMs will struggle to choose the right tool.