mcc

A CLI tool for managing isolated git clone workspaces, designed for running multiple Claude Code agents on the same GitHub project simultaneously.

Each workspace gets its own directory and feature branch, so agents don't step on each other.

Install

Prerequisites: Node.js 18+, git, and optionally gh CLI for PR creation and default branch detection.

npm install -g @maafk/mcc

Or from source:

git clone https://github.com/maafk/mcc.git
cd mcc
pnpm install
pnpm build
pnpm link --global

Quick Start

# Register a repo
mcc init https://github.com/your-org/your-project

# Create a workspace — interactive mode prompts for project and branch
mcc start

# Or specify the branch directly
mcc start feature-auth

# Workspaces are cloned into your current directory:
#   ./your-project/feature-auth/
# Open a terminal there and run claude

# See all workspaces
mcc list

# When done, push and create a PR
mcc finish feature-auth

# Clean up the workspace
mcc clean feature-auth

Commands

| Command | Description | |---------|-------------| | mcc init <repo-url> | Register a GitHub repo (SSH or HTTPS) | | mcc start [branch] | Clone the repo and create a feature branch (interactive if no args) | | mcc list | Show all active workspaces | | mcc status | Show git status and recent commits for each workspace | | mcc finish <branch> | Push the branch, create a PR, optionally clean up | | mcc clean <branch> | Delete a workspace directory and remove from state | | mcc projects | List all registered repos |

Options

start, finish, and clean accept -p, --project <name> to specify which project when you have multiple registered. If omitted with multiple projects, you'll be prompted to select one.

How It Works

• Workspaces are cloned into your current directory as ./<repo>/<branch>/
• Global state is tracked in ~/.mcc/state.json
• Each start does a fresh git clone + git checkout -b
• finish pushes to origin and uses gh pr create if the gh CLI is available

Development

pnpm install
pnpm test          # run tests
pnpm test:watch    # run tests in watch mode
pnpm build         # compile TypeScript to dist/

License

MIT