Manage Claude Code in style!
Try it instantly at vibecraft.sh — still connects to your local Claude Code instances!
New:
- Spatial Audio — Claude behind you? Claude on your left? No claublem!
- Animations — What's Claude up to? Watch him! ◕ ‿ ◕
Vibecraft uses your own local Claude Code instances — no files or prompts are shared.
- macOS or Linux (Windows not supported - hooks require bash)
- Node.js 18+
- jq - for hook scripts (
brew install jq/apt install jq) - tmux - for session management (
brew install tmux/apt install tmux)
# 1. Install dependencies
brew install jq tmux # macOS
# sudo apt install jq tmux # Ubuntu/Debian
# 2. Configure hooks (one time)
npx vibecraft setup
# 3. Start server
npx vibecraftOpen http://localhost:4003 and use Claude Code normally. You'll see Claude move around the workshop as it uses tools.
From source:
git clone https://github.com/nearcyan/vibecraft
cd vibecraft && npm install && npm run dev
# Opens on http://localhost:4002To uninstall: npx vibecraft uninstall (removes hooks, keeps your data)
Run Claude in tmux to send prompts from browser:
tmux new -s claude
claudeThen use the input field in the visualization with "Send to tmux" checked.
| Station | Tools | Details |
|---|---|---|
| Bookshelf | Read | Books on shelves |
| Desk | Write | Paper, pencil, ink pot |
| Workbench | Edit | Wrench, gears, bolts |
| Terminal | Bash | Glowing screen |
| Scanner | Grep, Glob | Telescope with lens |
| Antenna | WebFetch, WebSearch | Satellite dish |
| Portal | Task (subagents) | Glowing ring portal |
| Taskboard | TodoWrite | Board with sticky notes |
- Floating context labels - See file paths and commands above active stations
- Thought bubbles - Claude shows thinking animation while processing
- Response capture - Claude's responses appear in the activity feed
- Subagent visualization - Mini-Claudes spawn at portal for parallel tasks
- Cancel button - Send Ctrl+C to interrupt Claude
- Split-screen layout - 60% 3D scene (Workshop), 40% activity feed
- Voice input - Speak prompts with real-time transcription (requires Deepgram API key)
- Attention system - Zones pulse when sessions need input or finish
- Sound effects - Synthesized audio feedback for tools and events (docs/SOUND.md)
- Draw mode - Paint hex tiles with colors, 3D stacking, and text labels (press
D) - Text labels - Add multi-line labels to hex tiles with custom modal
- Zone context menus - Right-click zones for Info (
I) or quick Command (C) input - Station panels - Toggle with
Pto see recent tool history per workstation - Context-aware animations - Claude celebrates commits, shakes head on errors
Run multiple Claude instances and direct work to each:
- Click "+ New" (or
Alt+N) to spawn a new session - Configure name, directory, and flags (
-r,--chrome,--dangerously-skip-permissions) - Click a session or press
1-6(orAlt+1-6in inputs) to select it - Send prompts to whichever Claude you want
Each session runs in its own tmux, with status tracking (idle/working/offline).
See docs/ORCHESTRATION.md for the full API and architecture.
| Key | Action |
|---|---|
Tab / Esc |
Switch focus between Workshop and Feed |
1-6 |
Switch to session (extended: QWERTY, ASDFGH, ZXCVBN) |
0 / ` |
All sessions / overview |
Alt+N |
New session |
Alt+R |
Toggle voice input |
F |
Toggle follow mode |
P |
Toggle station panels |
D |
Toggle draw mode |
Draw mode: 1-6 colors, 0 eraser, Q/E brush size, R 3D stack, X clear
vibecraft [options]
Options:
--port, -p <port> WebSocket server port (default: 4003)
--help, -h Show help
--version, -v Show versionSee docs/SETUP.md for detailed setup guide. See CLAUDE.md for technical documentation.
Website: https://vibecraft.sh
MIT