Room-scoped event fabric connecting local Claude Code sessions with a shared web canvas. Enables ambient presence between developers and bidirectional interactions while enforcing strict privacy — no code, messages, or context ever leave your machine.
AgentSmith is a Claude Code plugin that captures lifecycle events (session start/stop, tool use, prompts, etc.) and streams them to a shared room via a lightweight local proxy. Other developers in the same room see each other's activity on a web canvas in real time.
Claude Code → plugin hooks → local proxy → API server → shared room
- Privacy first — only event metadata is transmitted, never code or conversation content
- Non-blocking — all hooks run asynchronously, so Claude Code stays fast
- Room-scoped — events are isolated per room; join different rooms per project
macOS / Linux:
curl -LsSf https://agentsmith.me/install.sh | shWindows (PowerShell):
irm https://agentsmith.me/install.ps1 | iexThe installer checks prerequisites (Claude Code, Bun), adds the marketplace, lets you choose an install scope, and configures your username and server URL.
- Claude Code (v2.1.34+)
- Bun runtime (required by the local proxy)
# Step 1: Add the marketplace
claude plugin marketplace add plosson/agentsmith
# Step 2: Install the plugin (pick one)
claude plugin install agentsmith@agentsmith-marketplace # all projects (recommended)
claude plugin install agentsmith@agentsmith-marketplace -s project # this project, shared with team
claude plugin install agentsmith@agentsmith-marketplace -s local # this project, just youmacOS / Linux:
curl -LsSf https://agentsmith.me/uninstall.sh | shWindows (PowerShell):
irm https://agentsmith.me/uninstall.ps1 | iexOr if you have the repo cloned:
./scripts/uninstall.shThis removes the plugin from all scopes, removes the marketplace, and optionally deletes your config.
claude plugin uninstall agentsmith # remove from user scope
claude plugin uninstall agentsmith -s project # remove from project scope
claude plugin uninstall agentsmith -s local # remove from local scope
claude plugin marketplace remove agentsmith-marketplace
rm -rf ~/.config/agentsmith # optional: remove configgit clone https://github.com/plosson/agentsmith.git
cd agentsmith
claude --plugin-dir ./pluginCreate ~/.config/agentsmith/config with the following variables:
AGENTSMITH_SERVER_URL=https://your-server.example.com # API server URL
AGENTSMITH_KEY=your-auth-token # Auth token
AGENTSMITH_ROOM=default # Room nameThe local proxy URL (AGENTSMITH_CLIENT_URL) is written automatically when the proxy starts.
| Command | Description |
|---|---|
/room [name] |
Set the active room for this project (override) |
/room |
Show the current room |
/room reset |
Remove the project override, use default room |
/server status |
Show proxy status, config, and connectivity |
/server restart |
Restart the local proxy |
The plugin captures the full Claude Code lifecycle:
SessionStart SessionEnd UserPromptSubmit PreToolUse PostToolUse PostToolUseFailure PermissionRequest Stop Notification SubagentStart SubagentStop TeammateIdle TaskCompleted PreCompact
agentsmith/
├── packages/
│ ├── api/ # REST API server (Hono + SQLite)
│ └── shared/ # Shared types & Zod schemas
├── plugin/ # Claude Code plugin
│ ├── hooks/ # Shell scripts + local Bun proxy
│ └── commands/ # /room, /server
└── docker/ # Deployment
Tech stack: Bun, TypeScript, Hono, SQLite, Zod, Auth0, Biome
bun install # Install dependencies
bun run dev:api # Start API server (watch mode)
bun test # Run all tests
bun run lint # Biome lint
bun run format # Biome format
bun run typecheck # TypeScript checkMIT