Skip to content

v0.1.0 — initial release

Choose a tag to compare

View all tags
@garniergeorges garniergeorges released this 24 Apr 00:49
· 28 commits to main since this release
v0.1.0
bc2bdcd

First public release of claude-presence — a minimal MCP server that lets multiple Claude Code sessions on the same repo coordinate without stepping on each other.

What's in this release

Core features

  • Presence registry — every session declares itself (project, branch, intent) and sees the others
  • Named resource locks — advisory locks on arbitrary strings (ci, deploy:staging, port:3000, db:staging, …) to prevent concurrent conflicting operations
  • Broadcast inbox — short messages shared between sessions on the same project
  • Automatic cleanup — dead sessions pruned after 2 min without heartbeat; locks expire via TTL (default 10 min, max 24 h)

9 MCP tools

session_register · session_heartbeat · session_unregister · session_list · resource_claim · resource_release · resource_list · broadcast · read_inbox

4 slash commands (ship-ready)

/register · /claim <resource> [reason] · /release <resource> · /presence

Copy commands/*.md into ~/.claude/commands/ and they're available in every Claude Code session.

CLI (claude-presence)

status · locks · clear · path · help — all with --json support for scripting.

Optional hooks

  • SessionStart — reminder at session start
  • UserPromptSubmit — one-line system message when other sessions or locks are active

Install

git clone https://github.com/garniergeorges/claude-presence
cd claude-presence
npm install && npm run build && npm link

Then in each project you want to coordinate, add to .mcp.json:

{
  "mcpServers": {
    "claude-presence": { "type": "stdio", "command": "claude-presence-mcp" }
  }
}

See the README (EN / FR) for the full guide, verification steps, and troubleshooting.

Design notes

  • Zero daemon, zero network. SQLite in ~/.claude-presence/state.db (WAL mode). Nothing leaves your machine.
  • Named resource locks, not file locks. Complementary to mcp_agent_mail and parallel-cc, which focus on file-level reservations.
  • Explicit over magical. Sessions register themselves via /register — no hidden auto-registration — so session IDs stay identifiable and the user keeps control.

Requirements

  • Node.js ≥ 18
  • Claude Code (or any MCP-compatible client)
  • macOS, Linux, Windows

Status

v0.1 — early release. API may shift based on feedback. Issues and PRs welcome.

Assets 2
Loading