ccb-multi 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,31 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [0.1.0] - 2026-02-13
+
+### Added
+
+- Initial release of ccb-multi toolkit
+- Multi-instance support for CCB (Claude Code Bridge)
+- Professional ASCII art branding (CCB-MULTI logo)
+- Four CLI commands:
+  - `ccb-multi` - Start CCB instance with specified providers
+  - `ccb-multi-status` - View status of all instances
+  - `ccb-multi-history` - View shared session history
+  - `ccb-multi-clean` - Clean up instance directories
+- Shared session history across all instances via symlinks
+- Isolated workspace for each instance
+- Cross-platform compatibility (Windows, macOS, Linux)
+- Comprehensive documentation with:
+  - CCB background and single-instance problem explanation
+  - Design philosophy and architecture diagram
+  - Prerequisites and installation guide
+  - Usage examples and comparison with git worktree
+
+### Features
+
+- Better solution than git worktree for parallel AI coding sessions
+- Automatic instance isolation and cleanup
+- Unified status tracking across all instances
+- Shared resources (history, config) via symlinks

package/README.md

@@ -0,0 +1,232 @@
+# CCB-Multi - Multi-Instance Manager for Claude Code Bridge
+
+Multi-instance manager for CCB (Claude Code Bridge) - Run multiple AI coding sessions in parallel.
+
+## Background
+
+### What is CCB?
+
+[CCB (Claude Code Bridge)](https://github.com/bfly123/claude_code_bridge) is a powerful tool for real-time multi-AI collaboration, supporting Claude, Codex, and Gemini with persistent context and minimal token overhead.
+
+**CCB's Strengths:**
+- 🤖 Multi-AI provider support (Claude, Codex, Gemini)
+- 🔄 Powerful task scheduling and orchestration
+- 💾 Persistent context across sessions
+- ⚡ Efficient token usage
+
+### The Single-Instance Problem
+
+**CCB runs as a single instance**, which creates significant limitations during development:
+
+**Common Development Scenarios:**
+
+1. **Parallel Feature Development**
+   - You're implementing Feature A with Claude
+   - Suddenly need to fix a critical bug in Feature B
+   - Must stop Feature A session, lose context, switch to Feature B
+   - Can't leverage Codex for Feature A while Claude handles Feature B
+
+2. **Multi-Provider Workflows**
+   - Want Claude to review architecture
+   - Want Codex to implement algorithms
+   - Want Gemini to write documentation
+   - Can only run one at a time, losing the parallel efficiency
+
+3. **Context Switching Overhead**
+   - Each time you switch tasks, you lose the current session context
+   - Need to rebuild context when returning to previous task
+   - Wastes time and tokens re-explaining the same context
+
+**The Pain Point:** CCB's powerful capabilities are bottlenecked by single-instance limitation. You can't fully utilize multiple AI providers in parallel for different tasks.
+
+## Our Solution: ccb-multi
+
+ccb-multi solves the single-instance problem by enabling **multiple isolated CCB instances** while maintaining **shared session history**.
+
+### Design Philosophy
+
+**Instance Isolation + History Sharing**
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                    Your Project Root                         │
+├─────────────────────────────────────────────────────────────┤
+│                                                              │
+│  .ccb/                                                       │
+│  ├── history/          ← Shared across all instances        │
+│  └── ccb.config        ← Shared configuration               │
+│                                                              │
+│  .ccb-instances/                                             │
+│  ├── instance-1/       ← Isolated workspace (Feature A)     │
+│  │   ├── .ccb/                                              │
+│  │   │   └── history → ../../.ccb/history/  (symlink)       │
+│  │   └── [working files]                                    │
+│  │                                                           │
+│  └── instance-2/       ← Isolated workspace (Feature B)     │
+│      ├── .ccb/                                              │
+│      │   └── history → ../../.ccb/history/  (symlink)       │
+│      └── [working files]                                    │
+│                                                              │
+└─────────────────────────────────────────────────────────────┘
+```
+
+**Key Design Decisions:**
+
+1. **Isolated Workspaces**: Each instance has its own directory to avoid file conflicts
+2. **Shared History**: All instances share `.ccb/history/` via symlinks for context continuity
+3. **Shared Config**: Common configuration across all instances
+4. **File Sync**: Changes sync back to project root automatically
+
+### Why Not Git Worktree?
+
+You might think: "Can't I just use `git worktree` for multiple working directories?"
+
+**Git worktree** is a valid approach, but has limitations:
+
+| Aspect | git worktree | ccb-multi |
+|--------|-------------|-----------|
+| **Session History** | ❌ Separate per worktree | ✅ Shared across instances |
+| **Setup** | ❌ Manual worktree management | ✅ One command to start |
+| **Cleanup** | ❌ Manual removal needed | ✅ Automatic cleanup |
+| **Status Tracking** | ❌ No unified view | ✅ See all instances at once |
+
+**ccb-multi** is purpose-built for CCB's multi-instance needs, with automatic history sharing and instance management.
+
+## Features
+
+✅ **Multi-instance Support**: Run multiple CCB instances simultaneously
+✅ **Shared History**: All instances share conversation history and memory
+✅ **Cross-platform**: Works on Windows, macOS, and Linux
+✅ **Easy to Use**: Simple CLI commands
+✅ **Monorepo Friendly**: Works with any project structure
+
+## Prerequisites
+
+Before installing ccb-multi, you need to have the following installed:
+
+### 1. CCB (Claude Code Bridge)
+
+CCB must be installed and configured on your system.
+
+```bash
+# Install CCB (follow CCB's official installation guide)
+# https://github.com/bfly123/claude_code_bridge
+```
+
+### 2. tmux
+
+ccb-multi requires tmux to manage multiple terminal sessions.
+
+**macOS:**
+```bash
+brew install tmux
+```
+
+**Linux (Ubuntu/Debian):**
+```bash
+sudo apt-get install tmux
+```
+
+**Linux (CentOS/RHEL):**
+```bash
+sudo yum install tmux
+```
+
+**Windows:**
+```bash
+# Use WSL (Windows Subsystem for Linux) and install tmux in WSL
+```
+
+### 3. Start tmux
+
+**IMPORTANT**: You must run ccb-multi inside a tmux session.
+
+```bash
+# Start tmux
+tmux
+
+# Or attach to existing session
+tmux attach
+```
+
+## Installation
+
+```bash
+npm install -g ccb-multi
+```
+
+## Usage
+
+### Start an instance
+
+```bash
+# Start instance 1 with specific providers
+ccb-multi 1 codex gemini claude
+
+# Start instance 2
+ccb-multi 2 codex gemini claude
+
+# Start instance without specifying providers (uses config)
+ccb-multi 1
+```
+
+### Check status
+
+```bash
+ccb-multi-status
+```
+
+### View history
+
+```bash
+ccb-multi-history
+```
+
+### Clean up instances
+
+```bash
+ccb-multi-clean
+```
+
+## How it Works
+
+1. **Instance Isolation**: Each instance runs in its own directory (`.ccb-instances/instance-N`)
+2. **Shared Resources**: All instances share:
+   - `.ccb/history/` - Conversation history
+   - `.ccb/ccb.config` - Configuration
+3. **File Sync**: All file changes are synced to the project root via symlinks
+
+## Project Structure
+
+```
+your-project/
+  .ccb/
+    history/              # Shared history (all instances)
+    ccb.config           # Shared config
+  .ccb-instances/
+    instance-1/          # Instance 1
+      .ccb/
+        history -> ../../.ccb/history/
+    instance-2/          # Instance 2
+      .ccb/
+        history -> ../../.ccb/history/
+```
+
+## Requirements
+
+- Node.js >= 14.0.0
+- CCB (Claude Code Bridge) installed
+- tmux installed and running
+
+## License
+
+MIT
+
+## Author
+
+dalio willd
+
+## Repository
+
+https://github.com/waoooo/ccb-multi
+

package/bin/ccb-multi-clean.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+require('../lib/cli/ccb-multi-clean.js');

package/bin/ccb-multi-history.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+require('../lib/cli/ccb-multi-history.js');

package/bin/ccb-multi-status.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+require('../lib/cli/ccb-multi-status.js');

package/bin/ccb-multi.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+require('../lib/cli/ccb-multi.js');

package/lib/cli/ccb-multi-clean.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=ccb-multi-clean.d.ts.map

package/lib/cli/ccb-multi-clean.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ccb-multi-clean.d.ts","sourceRoot":"","sources":["../../src/cli/ccb-multi-clean.ts"],"names":[],"mappings":""}

package/lib/cli/ccb-multi-clean.js

@@ -0,0 +1,104 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+const utils_1 = require("../lib/utils");
+const commander_1 = require("commander");
+const program = new commander_1.Command();
+program
+    .name('ccb-multi-clean')
+    .description('Clean up CCB multi-instance directories')
+    .option('-f, --force', 'Force clean without confirmation')
+    .action(async (options) => {
+    try {
+        const projectInfo = (0, utils_1.getProjectInfo)();
+        const instancesDir = (0, utils_1.getInstancesDir)(projectInfo.root);
+        console.log('');
+        console.log(chalk_1.default.cyan('    ██████╗ ██████╗██████╗       ███╗   ███╗██╗   ██╗██╗  ████████╗██╗'));
+        console.log(chalk_1.default.cyan('   ██╔════╝██╔════╝██╔══██╗      ████╗ ████║██║   ██║██║  ╚══██╔══╝██║'));
+        console.log(chalk_1.default.cyan('   ██║     ██║     ██████╔╝█████╗██╔████╔██║██║   ██║██║     ██║   ██║'));
+        console.log(chalk_1.default.cyan('   ██║     ██║     ██╔══██╗╚════╝██║╚██╔╝██║██║   ██║██║     ██║   ██║'));
+        console.log(chalk_1.default.cyan('   ╚██████╗╚██████╗██████╔╝      ██║ ╚═╝ ██║╚██████╔╝███████╗██║   ██║'));
+        console.log(chalk_1.default.cyan('    ╚═════╝ ╚═════╝╚═════╝       ╚═╝     ╚═╝ ╚═════╝ ╚══════╝╚═╝   ╚═╝'));
+        console.log('');
+        console.log('  Multi-Instance Cleanup');
+        console.log('');
+        if (!fs.existsSync(instancesDir)) {
+            console.log(chalk_1.default.dim('  No instances directory found'));
+            return;
+        }
+        const instances = fs.readdirSync(instancesDir)
+            .filter(name => name.startsWith('instance-'));
+        if (instances.length === 0) {
+            console.log(chalk_1.default.dim('  No instances to clean'));
+            return;
+        }
+        console.log(chalk_1.default.dim(`  Found ${instances.length} instance(s) to remove:`));
+        console.log('');
+        instances.forEach(name => {
+            console.log(chalk_1.default.dim(`    ${name}`));
+        });
+        console.log('');
+        if (!options.force) {
+            console.log(chalk_1.default.yellow('  Warning: This will delete all instance directories'));
+            console.log(chalk_1.default.dim('  (shared history will be preserved)'));
+            console.log('');
+            console.log(chalk_1.default.dim('  Run with --force to confirm'));
+            console.log('');
+            return;
+        }
+        // Clean up instances
+        for (const instance of instances) {
+            const instancePath = path.join(instancesDir, instance);
+            fs.rmSync(instancePath, { recursive: true, force: true });
+            console.log(chalk_1.default.green(`  ✓ Removed ${instance}`));
+        }
+        console.log('');
+        console.log(chalk_1.default.green('  Cleanup complete'));
+        console.log('');
+    }
+    catch (error) {
+        console.error(chalk_1.default.red('  ✗ Error:'), error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+});
+program.parse();
+//# sourceMappingURL=ccb-multi-clean.js.map

package/lib/cli/ccb-multi-clean.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ccb-multi-clean.js","sourceRoot":"","sources":["../../src/cli/ccb-multi-clean.ts"],"names":[],"mappings":"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"}

package/lib/cli/ccb-multi-history.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=ccb-multi-history.d.ts.map

package/lib/cli/ccb-multi-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ccb-multi-history.d.ts","sourceRoot":"","sources":["../../src/cli/ccb-multi-history.ts"],"names":[],"mappings":""}

package/lib/cli/ccb-multi-history.js

@@ -0,0 +1,99 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+const utils_1 = require("../lib/utils");
+async function main() {
+    try {
+        const projectInfo = (0, utils_1.getProjectInfo)();
+        const historyDir = path.join(projectInfo.root, '.ccb', 'history');
+        console.log('');
+        console.log(chalk_1.default.cyan('    ██████╗ ██████╗██████╗       ███╗   ███╗██╗   ██╗██╗  ████████╗██╗'));
+        console.log(chalk_1.default.cyan('   ██╔════╝██╔════╝██╔══██╗      ████╗ ████║██║   ██║██║  ╚══██╔══╝██║'));
+        console.log(chalk_1.default.cyan('   ██║     ██║     ██████╔╝█████╗██╔████╔██║██║   ██║██║     ██║   ██║'));
+        console.log(chalk_1.default.cyan('   ██║     ██║     ██╔══██╗╚════╝██║╚██╔╝██║██║   ██║██║     ██║   ██║'));
+        console.log(chalk_1.default.cyan('   ╚██████╗╚██████╗██████╔╝      ██║ ╚═╝ ██║╚██████╔╝███████╗██║   ██║'));
+        console.log(chalk_1.default.cyan('    ╚═════╝ ╚═════╝╚═════╝       ╚═╝     ╚═╝ ╚═════╝ ╚══════╝╚═╝   ╚═╝'));
+        console.log('');
+        console.log('  Session History');
+        console.log('');
+        if (!fs.existsSync(historyDir)) {
+            console.log(chalk_1.default.dim('  No history directory found'));
+            return;
+        }
+        console.log(chalk_1.default.dim('  RECENT SESSIONS (shared across all instances)'));
+        console.log('');
+        // List recent history files
+        const files = fs.readdirSync(historyDir)
+            .filter(name => name.endsWith('.md'))
+            .map(name => ({
+            name,
+            path: path.join(historyDir, name),
+            stat: fs.statSync(path.join(historyDir, name))
+        }))
+            .sort((a, b) => b.stat.mtimeMs - a.stat.mtimeMs)
+            .slice(0, 10);
+        if (files.length === 0) {
+            console.log(chalk_1.default.dim('  No session history found'));
+            return;
+        }
+        for (const file of files) {
+            const provider = file.name.split('-')[0];
+            const size = (file.stat.size / 1024).toFixed(1) + 'K';
+            const time = file.stat.mtime.toLocaleString('en-US', {
+                month: 'short',
+                day: 'numeric',
+                hour: '2-digit',
+                minute: '2-digit'
+            });
+            console.log(`    ${chalk_1.default.cyan(provider.padEnd(8))}  ${chalk_1.default.dim(size.padEnd(8))}  ${chalk_1.default.dim(time)}`);
+        }
+        console.log('');
+        console.log(chalk_1.default.dim(`    History location: ${historyDir}`));
+        console.log('');
+    }
+    catch (error) {
+        console.error(chalk_1.default.red('  ✗ Error:'), error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=ccb-multi-history.js.map

package/lib/cli/ccb-multi-history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ccb-multi-history.js","sourceRoot":"","sources":["../../src/cli/ccb-multi-history.ts"],"names":[],"mappings":"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"}

package/lib/cli/ccb-multi-status.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=ccb-multi-status.d.ts.map

package/lib/cli/ccb-multi-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ccb-multi-status.d.ts","sourceRoot":"","sources":["../../src/cli/ccb-multi-status.ts"],"names":[],"mappings":""}

package/lib/cli/ccb-multi-status.js

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const chalk_1 = __importDefault(require("chalk"));
+const utils_1 = require("../lib/utils");
+async function main() {
+    try {
+        const projectInfo = (0, utils_1.getProjectInfo)();
+        const instances = (0, utils_1.listInstances)(projectInfo.root);
+        console.log('');
+        console.log(chalk_1.default.cyan('    ██████╗ ██████╗██████╗       ███╗   ███╗██╗   ██╗██╗  ████████╗██╗'));
+        console.log(chalk_1.default.cyan('   ██╔════╝██╔════╝██╔══██╗      ████╗ ████║██║   ██║██║  ╚══██╔══╝██║'));
+        console.log(chalk_1.default.cyan('   ██║     ██║     ██████╔╝█████╗██╔████╔██║██║   ██║██║     ██║   ██║'));
+        console.log(chalk_1.default.cyan('   ██║     ██║     ██╔══██╗╚════╝██║╚██╔╝██║██║   ██║██║     ██║   ██║'));
+        console.log(chalk_1.default.cyan('   ╚██████╗╚██████╗██████╔╝      ██║ ╚═╝ ██║╚██████╔╝███████╗██║   ██║'));
+        console.log(chalk_1.default.cyan('    ╚═════╝ ╚═════╝╚═════╝       ╚═╝     ╚═╝ ╚═════╝ ╚══════╝╚═╝   ╚═╝'));
+        console.log('');
+        console.log('  Multi-Instance Status');
+        console.log('');
+        if (instances.length === 0) {
+            console.log(chalk_1.default.dim('    No instances found'));
+            return;
+        }
+        let runningCount = 0;
+        let stoppedCount = 0;
+        console.log(chalk_1.default.dim('  INSTANCES'));
+        console.log('');
+        for (const instanceId of instances) {
+            const running = (0, utils_1.isInstanceRunning)(projectInfo.root, instanceId);
+            if (running) {
+                console.log(`  ${chalk_1.default.green('●')} Instance ${instanceId}  ${chalk_1.default.dim('running')}`);
+                runningCount++;
+            }
+            else {
+                console.log(`  ${chalk_1.default.dim('○')} Instance ${instanceId}  ${chalk_1.default.dim('stopped')}`);
+                stoppedCount++;
+            }
+        }
+        console.log('');
+        console.log(chalk_1.default.dim('  SUMMARY'));
+        console.log('');
+        console.log(`    Total      ${instances.length}`);
+        console.log(`    Running    ${chalk_1.default.green(runningCount.toString())}`);
+        console.log(`    Stopped    ${chalk_1.default.dim(stoppedCount.toString())}`);
+        console.log('');
+    }
+    catch (error) {
+        console.error(chalk_1.default.red('  ✗ Error:'), error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=ccb-multi-status.js.map

package/lib/cli/ccb-multi-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ccb-multi-status.js","sourceRoot":"","sources":["../../src/cli/ccb-multi-status.ts"],"names":[],"mappings":"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"}

package/lib/cli/ccb-multi.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=ccb-multi.d.ts.map

package/lib/cli/ccb-multi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ccb-multi.d.ts","sourceRoot":"","sources":["../../src/cli/ccb-multi.ts"],"names":[],"mappings":""}

package/lib/cli/ccb-multi.js

@@ -0,0 +1,45 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const instance_1 = require("../lib/instance");
+const utils_1 = require("../lib/utils");
+const chalk_1 = __importDefault(require("chalk"));
+const program = new commander_1.Command();
+program
+    .name('ccb-multi')
+    .description('Multi-instance manager for CCB (Claude Code Bridge)')
+    .version('1.0.0')
+    .argument('<instance-id>', 'Instance ID (1, 2, 3, ...)')
+    .argument('[providers...]', 'AI providers (e.g., codex gemini claude)')
+    .action(async (instanceId, providers) => {
+    try {
+        const projectInfo = (0, utils_1.getProjectInfo)();
+        console.log('');
+        console.log(chalk_1.default.cyan('    ██████╗ ██████╗██████╗       ███╗   ███╗██╗   ██╗██╗  ████████╗██╗'));
+        console.log(chalk_1.default.cyan('   ██╔════╝██╔════╝██╔══██╗      ████╗ ████║██║   ██║██║  ╚══██╔══╝██║'));
+        console.log(chalk_1.default.cyan('   ██║     ██║     ██████╔╝█████╗██╔████╔██║██║   ██║██║     ██║   ██║'));
+        console.log(chalk_1.default.cyan('   ██║     ██║     ██╔══██╗╚════╝██║╚██╔╝██║██║   ██║██║     ██║   ██║'));
+        console.log(chalk_1.default.cyan('   ╚██████╗╚██████╗██████╔╝      ██║ ╚═╝ ██║╚██████╔╝███████╗██║   ██║'));
+        console.log(chalk_1.default.cyan('    ╚═════╝ ╚═════╝╚═════╝       ╚═╝     ╚═╝ ╚═════╝ ╚══════╝╚═╝   ╚═╝'));
+        console.log('');
+        console.log('  Multi-Instance Manager for Claude Code Bridge');
+        console.log('');
+        console.log(chalk_1.default.dim(`    Project     ${projectInfo.name}`));
+        console.log(chalk_1.default.dim(`    Instance    ${instanceId}`));
+        if (providers.length > 0) {
+            console.log(chalk_1.default.dim(`    Providers   ${providers.join(', ')}`));
+        }
+        console.log('');
+        await (0, instance_1.startInstance)(instanceId, providers, projectInfo);
+    }
+    catch (error) {
+        console.error(chalk_1.default.red('  ✗ Error:'), error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+});
+program.parse();
+//# sourceMappingURL=ccb-multi.js.map

package/lib/cli/ccb-multi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ccb-multi.js","sourceRoot":"","sources":["../../src/cli/ccb-multi.ts"],"names":[],"mappings":";;;;;;AAEA,yCAAoC;AACpC,8CAAgD;AAChD,wCAA8C;AAC9C,kDAA0B;AAE1B,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,WAAW,CAAC;KACjB,WAAW,CAAC,qDAAqD,CAAC;KAClE,OAAO,CAAC,OAAO,CAAC;KAChB,QAAQ,CAAC,eAAe,EAAE,4BAA4B,CAAC;KACvD,QAAQ,CAAC,gBAAgB,EAAE,0CAA0C,CAAC;KACtE,MAAM,CAAC,KAAK,EAAE,UAAkB,EAAE,SAAmB,EAAE,EAAE;IACxD,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,IAAA,sBAAc,GAAE,CAAC;QAErC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,wEAAwE,CAAC,CAAC,CAAC;QAClG,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,wEAAwE,CAAC,CAAC,CAAC;QAClG,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,wEAAwE,CAAC,CAAC,CAAC;QAClG,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,wEAAwE,CAAC,CAAC,CAAC;QAClG,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,wEAAwE,CAAC,CAAC,CAAC;QAClG,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,wEAAwE,CAAC,CAAC,CAAC;QAClG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC;QAC/D,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,GAAG,CAAC,mBAAmB,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAC9D,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,GAAG,CAAC,mBAAmB,UAAU,EAAE,CAAC,CAAC,CAAC;QAExD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,GAAG,CAAC,mBAAmB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QACpE,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAEhB,MAAM,IAAA,wBAAa,EAAC,UAAU,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;IAE1D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACvF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "ccb-multi",
+  "version": "0.1.0",
+  "description": "Multi-instance manager for CCB (Claude Code Bridge) - Run multiple AI coding sessions in parallel",
+  "main": "lib/index.js",
+  "bin": {
+    "ccb-multi": "./bin/ccb-multi.js",
+    "ccb-multi-status": "./bin/ccb-multi-status.js",
+    "ccb-multi-history": "./bin/ccb-multi-history.js",
+    "ccb-multi-clean": "./bin/ccb-multi-clean.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "ccb",
+    "claude",
+    "claude-code-bridge",
+    "multi-instance",
+    "ai",
+    "development",
+    "cli",
+    "parallel",
+    "coding-assistant"
+  ],
+  "author": "dalio willd",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/daniellee2015/ccb-multi.git"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0"
+  },
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "commander": "^11.0.0"
+  }
+}

package/src/cli/ccb-multi-clean.ts

@@ -0,0 +1,77 @@
+#!/usr/bin/env node
+
+import * as fs from 'fs';
+import * as path from 'path';
+import chalk from 'chalk';
+import { getProjectInfo, getInstancesDir } from '../lib/utils';
+import { Command } from 'commander';
+
+const program = new Command();
+
+program
+  .name('ccb-multi-clean')
+  .description('Clean up CCB multi-instance directories')
+  .option('-f, --force', 'Force clean without confirmation')
+  .action(async (options) => {
+    try {
+      const projectInfo = getProjectInfo();
+      const instancesDir = getInstancesDir(projectInfo.root);
+
+      console.log('');
+      console.log(chalk.cyan('    ██████╗ ██████╗██████╗       ███╗   ███╗██╗   ██╗██╗  ████████╗██╗'));
+      console.log(chalk.cyan('   ██╔════╝██╔════╝██╔══██╗      ████╗ ████║██║   ██║██║  ╚══██╔══╝██║'));
+      console.log(chalk.cyan('   ██║     ██║     ██████╔╝█████╗██╔████╔██║██║   ██║██║     ██║   ██║'));
+      console.log(chalk.cyan('   ██║     ██║     ██╔══██╗╚════╝██║╚██╔╝██║██║   ██║██║     ██║   ██║'));
+      console.log(chalk.cyan('   ╚██████╗╚██████╗██████╔╝      ██║ ╚═╝ ██║╚██████╔╝███████╗██║   ██║'));
+      console.log(chalk.cyan('    ╚═════╝ ╚═════╝╚═════╝       ╚═╝     ╚═╝ ╚═════╝ ╚══════╝╚═╝   ╚═╝'));
+      console.log('');
+      console.log('  Multi-Instance Cleanup');
+      console.log('');
+
+      if (!fs.existsSync(instancesDir)) {
+        console.log(chalk.dim('  No instances directory found'));
+        return;
+      }
+
+      const instances = fs.readdirSync(instancesDir)
+        .filter(name => name.startsWith('instance-'));
+
+      if (instances.length === 0) {
+        console.log(chalk.dim('  No instances to clean'));
+        return;
+      }
+
+      console.log(chalk.dim(`  Found ${instances.length} instance(s) to remove:`));
+      console.log('');
+      instances.forEach(name => {
+        console.log(chalk.dim(`    ${name}`));
+      });
+      console.log('');
+
+      if (!options.force) {
+        console.log(chalk.yellow('  Warning: This will delete all instance directories'));
+        console.log(chalk.dim('  (shared history will be preserved)'));
+        console.log('');
+        console.log(chalk.dim('  Run with --force to confirm'));
+        console.log('');
+        return;
+      }
+
+      // Clean up instances
+      for (const instance of instances) {
+        const instancePath = path.join(instancesDir, instance);
+        fs.rmSync(instancePath, { recursive: true, force: true });
+        console.log(chalk.green(`  ✓ Removed ${instance}`));
+      }
+
+      console.log('');
+      console.log(chalk.green('  Cleanup complete'));
+      console.log('');
+
+    } catch (error) {
+      console.error(chalk.red('  ✗ Error:'), error instanceof Error ? error.message : error);
+      process.exit(1);
+    }
+  });
+
+program.parse();

package/src/cli/ccb-multi-history.ts

@@ -0,0 +1,71 @@
+#!/usr/bin/env node
+
+import * as fs from 'fs';
+import * as path from 'path';
+import chalk from 'chalk';
+import { getProjectInfo } from '../lib/utils';
+
+async function main() {
+  try {
+    const projectInfo = getProjectInfo();
+    const historyDir = path.join(projectInfo.root, '.ccb', 'history');
+
+    console.log('');
+    console.log(chalk.cyan('    ██████╗ ██████╗██████╗       ███╗   ███╗██╗   ██╗██╗  ████████╗██╗'));
+    console.log(chalk.cyan('   ██╔════╝██╔════╝██╔══██╗      ████╗ ████║██║   ██║██║  ╚══██╔══╝██║'));
+    console.log(chalk.cyan('   ██║     ██║     ██████╔╝█████╗██╔████╔██║██║   ██║██║     ██║   ██║'));
+    console.log(chalk.cyan('   ██║     ██║     ██╔══██╗╚════╝██║╚██╔╝██║██║   ██║██║     ██║   ██║'));
+    console.log(chalk.cyan('   ╚██████╗╚██████╗██████╔╝      ██║ ╚═╝ ██║╚██████╔╝███████╗██║   ██║'));
+    console.log(chalk.cyan('    ╚═════╝ ╚═════╝╚═════╝       ╚═╝     ╚═╝ ╚═════╝ ╚══════╝╚═╝   ╚═╝'));
+    console.log('');
+    console.log('  Session History');
+    console.log('');
+
+    if (!fs.existsSync(historyDir)) {
+      console.log(chalk.dim('  No history directory found'));
+      return;
+    }
+
+    console.log(chalk.dim('  RECENT SESSIONS (shared across all instances)'));
+    console.log('');
+
+    // List recent history files
+    const files = fs.readdirSync(historyDir)
+      .filter(name => name.endsWith('.md'))
+      .map(name => ({
+        name,
+        path: path.join(historyDir, name),
+        stat: fs.statSync(path.join(historyDir, name))
+      }))
+      .sort((a, b) => b.stat.mtimeMs - a.stat.mtimeMs)
+      .slice(0, 10);
+
+    if (files.length === 0) {
+      console.log(chalk.dim('  No session history found'));
+      return;
+    }
+
+    for (const file of files) {
+      const provider = file.name.split('-')[0];
+      const size = (file.stat.size / 1024).toFixed(1) + 'K';
+      const time = file.stat.mtime.toLocaleString('en-US', {
+        month: 'short',
+        day: 'numeric',
+        hour: '2-digit',
+        minute: '2-digit'
+      });
+
+      console.log(`    ${chalk.cyan(provider.padEnd(8))}  ${chalk.dim(size.padEnd(8))}  ${chalk.dim(time)}`);
+    }
+
+    console.log('');
+    console.log(chalk.dim(`    History location: ${historyDir}`));
+    console.log('');
+
+  } catch (error) {
+    console.error(chalk.red('  ✗ Error:'), error instanceof Error ? error.message : error);
+    process.exit(1);
+  }
+}
+
+main();

package/src/cli/ccb-multi-status.ts

@@ -0,0 +1,59 @@
+#!/usr/bin/env node
+
+import chalk from 'chalk';
+import { getProjectInfo, listInstances, isInstanceRunning } from '../lib/utils';
+
+async function main() {
+  try {
+    const projectInfo = getProjectInfo();
+    const instances = listInstances(projectInfo.root);
+
+    console.log('');
+    console.log(chalk.cyan('    ██████╗ ██████╗██████╗       ███╗   ███╗██╗   ██╗██╗  ████████╗██╗'));
+    console.log(chalk.cyan('   ██╔════╝██╔════╝██╔══██╗      ████╗ ████║██║   ██║██║  ╚══██╔══╝██║'));
+    console.log(chalk.cyan('   ██║     ██║     ██████╔╝█████╗██╔████╔██║██║   ██║██║     ██║   ██║'));
+    console.log(chalk.cyan('   ██║     ██║     ██╔══██╗╚════╝██║╚██╔╝██║██║   ██║██║     ██║   ██║'));
+    console.log(chalk.cyan('   ╚██████╗╚██████╗██████╔╝      ██║ ╚═╝ ██║╚██████╔╝███████╗██║   ██║'));
+    console.log(chalk.cyan('    ╚═════╝ ╚═════╝╚═════╝       ╚═╝     ╚═╝ ╚═════╝ ╚══════╝╚═╝   ╚═╝'));
+    console.log('');
+    console.log('  Multi-Instance Status');
+    console.log('');
+
+    if (instances.length === 0) {
+      console.log(chalk.dim('    No instances found'));
+      return;
+    }
+
+    let runningCount = 0;
+    let stoppedCount = 0;
+
+    console.log(chalk.dim('  INSTANCES'));
+    console.log('');
+
+    for (const instanceId of instances) {
+      const running = isInstanceRunning(projectInfo.root, instanceId);
+
+      if (running) {
+        console.log(`  ${chalk.green('●')} Instance ${instanceId}  ${chalk.dim('running')}`);
+        runningCount++;
+      } else {
+        console.log(`  ${chalk.dim('○')} Instance ${instanceId}  ${chalk.dim('stopped')}`);
+        stoppedCount++;
+      }
+    }
+
+    console.log('');
+    console.log(chalk.dim('  SUMMARY'));
+    console.log('');
+    console.log(`    Total      ${instances.length}`);
+    console.log(`    Running    ${chalk.green(runningCount.toString())}`);
+    console.log(`    Stopped    ${chalk.dim(stoppedCount.toString())}`);
+    console.log('');
+
+  } catch (error) {
+    console.error(chalk.red('  ✗ Error:'), error instanceof Error ? error.message : error);
+    process.exit(1);
+  }
+}
+
+main();

package/src/cli/ccb-multi.ts

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+
+import { Command } from 'commander';
+import { startInstance } from '../lib/instance';
+import { getProjectInfo } from '../lib/utils';
+import chalk from 'chalk';
+
+const program = new Command();
+
+program
+  .name('ccb-multi')
+  .description('Multi-instance manager for CCB (Claude Code Bridge)')
+  .version('1.0.0')
+  .argument('<instance-id>', 'Instance ID (1, 2, 3, ...)')
+  .argument('[providers...]', 'AI providers (e.g., codex gemini claude)')
+  .action(async (instanceId: string, providers: string[]) => {
+    try {
+      const projectInfo = getProjectInfo();
+
+      console.log('');
+      console.log(chalk.cyan('    ██████╗ ██████╗██████╗       ███╗   ███╗██╗   ██╗██╗  ████████╗██╗'));
+      console.log(chalk.cyan('   ██╔════╝██╔════╝██╔══██╗      ████╗ ████║██║   ██║██║  ╚══██╔══╝██║'));
+      console.log(chalk.cyan('   ██║     ██║     ██████╔╝█████╗██╔████╔██║██║   ██║██║     ██║   ██║'));
+      console.log(chalk.cyan('   ██║     ██║     ██╔══██╗╚════╝██║╚██╔╝██║██║   ██║██║     ██║   ██║'));
+      console.log(chalk.cyan('   ╚██████╗╚██████╗██████╔╝      ██║ ╚═╝ ██║╚██████╔╝███████╗██║   ██║'));
+      console.log(chalk.cyan('    ╚═════╝ ╚═════╝╚═════╝       ╚═╝     ╚═╝ ╚═════╝ ╚══════╝╚═╝   ╚═╝'));
+      console.log('');
+      console.log('  Multi-Instance Manager for Claude Code Bridge');
+      console.log('');
+      console.log(chalk.dim(`    Project     ${projectInfo.name}`));
+      console.log(chalk.dim(`    Instance    ${instanceId}`));
+
+      if (providers.length > 0) {
+        console.log(chalk.dim(`    Providers   ${providers.join(', ')}`));
+      }
+
+      console.log('');
+
+      await startInstance(instanceId, providers, projectInfo);
+
+    } catch (error) {
+      console.error(chalk.red('  ✗ Error:'), error instanceof Error ? error.message : error);
+      process.exit(1);
+    }
+  });
+
+program.parse();

package/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "commonjs",
+    "lib": ["ES2020"],
+    "outDir": "./lib",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "lib"]
+}