supervibes

KO | EN

gitlite — search

#python #hacktoberfest #react #go #machine-learning #linux #macos #cli #kubernetes #vue #awesome-list #security #openai #open-source

(★ 32)

Super Vibes Nested Claud Code

supervibes 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Nested Claude Code

Run multiple Claude Code instances in parallel, orchestrated by a controller Claude Code instance that acts as a tech lead — decomposing your goal into focused sub-tasks and delegating each to its own terminal.

```
You → Dashboard → Controller Claude Code
                        ├── Terminal 1: Claude Code (ui)
                        ├── Terminal 2: Claude Code (api)
                        ├── Terminal 3: Claude Code (db)
                        └── Terminal 4: Claude Code (tests)
```

## Requirements

- **macOS** (uses Terminal.app for window management)
- **Node.js** (no dependencies to install)
- **tmux** — `brew install tmux`
- **Claude Code CLI** — installed and authenticated ([docs](https://docs.anthropic.com/en/docs/claude-code))

## Quick Start

```bash
git clone <repo-url>
cd nestedcc
node server.cjs
```

Open **http://localhost:3456** in your browser.

1. Type a goal (e.g. "Build a todo app with React and Express")
2. Pick terminal count (Auto lets the controller decide, or choose 1-6)
3. Pick a model (Sonnet, Opus, Haiku) — used for both the controller and child terminals
4. Set iterations (0 = one-shot, 1-5 = automatic improvement rounds after the initial build)
5. Click **Start**

Terminal windows will pop up on your screen — one per sub-task. The dashboard shows what the controller is doing in real-time.

## CLI Alternative

If you prefer a terminal-only experience:

```bash
node start.cjs
```

## How It Works

The controller is a Claude Code instance running in prompt mode. It receives a system prompt that tells it to act as a senior engineer who delegates work across parallel terminals. It uses a tmux control script to:

1. **Start** tmux sessions (each opens a Terminal window)
2. **Launch** Claude Code in each session
3. **Send** focused tasks with explicit file ownership ("You own src/api/. Don't touch other files.")
4. **Poll** terminal output to monitor progress
5. **Verify** the project works before finishing
6. **Clean up** all sessions

The children are fully independent Claude Code instances. They don't know about each other or the controller — they just receive a task and do it.

## What Happens On Screen

When you click Start, you'll see:

- **Dashboard** (left panel): Activity log showing every action the controller takes — starting terminals, sending prompts, reading output
- **Dashboard** (right panel): List of active terminals with click-to-expand prompts
- **Terminal windows**: macOS Terminal windows arranged side-by-side, one per child Claude Code instance

## Iterations

Setting iterations > 0 triggers automatic improvement rounds after the initial build. Each round spawns a fresh controller that:

1. Reviews the code built so far
2. Fixes bugs and improves quality
3. Adds one new feature
4. Verifies everything works

## Project Structure

```
server.cjs          — HTTP server, SSE streaming, controller process management
tmux-control.cjs    — tmux session manager (start, stop, send commands, read output)
public/index.html   — Web dashboard (single file, no dependencies)
start.cjs           — CLI launcher (alternative to the dashboard)
```

## Limitations

- **macOS only** — relies on Terminal.app and AppleScript for window management
- **No Linux/Windows support** — would need a different terminal management approach
- **Controller quality varies** — sometimes it under-parallelizes or sends overly broad prompts. The system prompt is tuned for this but it's not perfect.
- **No structured communication** — the controller talks to children by typing into terminals and reading screen output via tmux. There's no API or message passing.

## License

MIT

supervibes

supervibes 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

supervibes

supervibes 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README