Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (vibecraft) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Vibecraft

3D visualization of Claude Code as an interactive workshop. Watch Claude move between workstations as it uses tools.

npm

Requirements

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)

Quick Start

# 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 vibecraft

Open 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/Elysian-Labs/vibecraft
cd vibecraft && npm install && npm run dev
# Opens on http://localhost:4002

To uninstall: npx vibecraft uninstall (removes hooks, keeps your data)

Browser Control (Optional)

Run Claude in tmux to send prompts from browser:

tmux new -s claude
claude

Then use the input field in the visualization with "Send to tmux" checked.

Stations

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

Features

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
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

Orchestration (Multi-Claude)

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 (or Alt+1-6 in 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.

Keyboard Shortcuts

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
`D`	Toggle draw mode

Draw mode: 1-6 colors, 0 eraser, Q/E brush size, R 3D stack, X clear

CLI Options

vibecraft [options]

Options:
  --port, -p <port>    WebSocket server port (default: 4003)
  --help, -h           Show help
  --version, -v        Show version

See docs/SETUP.md for detailed setup guide. See CLAUDE.md for technical documentation.

Website: https://vibecraft.sh

License

MIT