vibeteam 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 asara
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,126 @@
+# VibTeam
+
+3D visualization of Claude Code as an interactive workshop. Watch Claude move between workstations as it uses tools.
+
+![Three.js](https://img.shields.io/badge/Three.js-black?logo=threedotjs) ![TypeScript](https://img.shields.io/badge/TypeScript-blue?logo=typescript&logoColor=white) ![npm](https://img.shields.io/npm/v/vibeteam)
+
+## 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
+
+```bash
+# 1. Install dependencies
+brew install jq tmux       # macOS
+# sudo apt install jq tmux  # Ubuntu/Debian
+
+# 2. Configure hooks (one time)
+npx vibeteam setup
+
+# 3. Start server
+npx vibeteam
+```
+
+Open http://localhost:4003 and use Claude Code normally. You'll see Claude move around the workshop as it uses tools.
+
+**From source:**
+```bash
+git clone https://github.com/Elysian-Labs/vibeteam
+cd vibeteam && npm install && npm run dev
+# Opens on http://localhost:4002
+```
+
+**To uninstall:** `npx vibeteam uninstall` (removes hooks, keeps your data)
+
+## Browser Control (Optional)
+
+Run Claude in tmux to send prompts from browser:
+
+```bash
+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 ([docs/SOUND.md](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 `P` to see recent tool history per workstation
+- **Context-aware animations** - Claude celebrates commits, shakes head on errors
+
+## Orchestration (Multi-Claude)
+
+Run multiple Claude instances and direct work to each:
+
+1. Click **"+ New"** (or `Alt+N`) to spawn a new session
+2. Configure name, directory, and flags (`-r`, `--chrome`, `--dangerously-skip-permissions`)
+3. Click a session or press `1-6` (or `Alt+1-6` in inputs) to select it
+4. Send prompts to whichever Claude you want
+
+Each session runs in its own tmux, with status tracking (idle/working/offline).
+
+See [docs/ORCHESTRATION.md](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 |
+| `P` | Toggle station panels |
+| `D` | Toggle draw mode |
+
+**Draw mode:** `1-6` colors, `0` eraser, `Q/E` brush size, `R` 3D stack, `X` clear
+
+## CLI Options
+
+```bash
+vibeteam [options]
+
+Options:
+  --port, -p <port>    WebSocket server port (default: 4003)
+  --help, -h           Show help
+  --version, -v        Show version
+```
+
+See [docs/SETUP.md](docs/SETUP.md) for detailed setup guide.
+See [CLAUDE.md](CLAUDE.md) for technical documentation.
+
+Website: https://vibeteam.sh
+
+## License
+
+MIT