npx claudepluginhub plosson/agentsmith --plugin agentsmithRoom-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
macOS / Linux:
curl -LsSf https://agentsmith.me/install.sh | sh
Windows (PowerShell):
irm https://agentsmith.me/install.ps1 | iex
The installer checks prerequisites (Claude Code, Bun), adds the marketplace, lets you choose an install scope, and configures your username and server URL.
# 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 you
macOS / Linux:
curl -LsSf https://agentsmith.me/uninstall.sh | sh
Windows (PowerShell):
irm https://agentsmith.me/uninstall.ps1 | iex
Or if you have the repo cloned:
./scripts/uninstall.sh
This 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 config
git clone https://github.com/plosson/agentsmith.git
cd agentsmith
claude --plugin-dir ./plugin
Create ~/.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 name
The 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 check
MIT
Ultra-compressed communication mode. Cuts ~75% of tokens while keeping full technical accuracy by speaking like a caveman.
Matches all tools
Hooks run on every tool call, not just specific ones
Comprehensive UI/UX design plugin for mobile (iOS, Android, React Native) and web applications with design systems, accessibility, and modern patterns
Intelligent prompt optimization using skill-based architecture. Enriches vague prompts with research-based clarifying questions before Claude Code executes them
Persistent memory system for Claude Code - seamlessly preserve context across sessions
Standalone image generation plugin using Nano Banana MCP server. Generates and edits images, icons, diagrams, patterns, and visual assets via Gemini image models. No Gemini CLI dependency required.