v0.3.0 — lock queue, session cleanup, inbox threading, CLI dashboard
TL;DR — Locks get a waiting queue with inbox notifications and heartbeat renewal, sessions clean up after dead processes, the inbox learns reply threading, and the CLI gains a live dashboard. Plus configurable retention TTLs and a same-branch warning.
Locks (#28)
resource_claimacceptswait: true: when the resource is held, the session joins a FIFO waiting queue and the response includesqueue_position.- On
resource_release(or lock expiry), the first waiter receives an inbox DM (prioritywarning), surfaced by the existing 🔔 banner at the next prompt. session_heartbeatacceptsrenew_locks: trueto push back the expiry of every held lock by its own TTL during long operations.resource_listnow shows waiting sessions per lock.
Sessions (#29)
session_unregisteracceptsclient_session_idas an alternative tosession_id(cleanup after aclient_session_id_conflict).claude-presence clear --session <id>/--client <uuid>remove one session explicitly.claude-presence clearalso prunes sessions whose recorded process is dead on the current host (remote/team sessions untouched).
Inbox (#31)
- Reply threading:
broadcastacceptsreply_to: <message id>; replies are addressed to the original sender as a DM unlessto_sessionsays otherwise. - Retention is configurable via
CLAUDE_PRESENCE_SESSION_TTL_SECONDS,CLAUDE_PRESENCE_LOCK_TTL_SECONDSandCLAUDE_PRESENCE_INBOX_RETENTION_SECONDS.
CLI (#32)
- New
claude-presence dashboard: sessions, locks and unread counts grouped by project, also in--json. --watch/-w(with--interval <s>) refreshesstatus,locksanddashboardin place.
Same-branch warning (#33)
- Registering on, or checking out, a branch another session is already working on now triggers a visible warning (tool response, CLI output and prompt banner).
Maintenance
- Bumped
fast-uriandhonooverrides for CVE-2026-13676 and CVE-2026-54290 (#30).
Test suite: 104 → 144 tests. Schema migrations are applied in place and covered by tests against the verbatim v0.2.1 schema.
Full changelog: v0.2.3...v0.3.0