autocc

autocc - Automated Claude Code Workspace Manager

Lightning-fast workspace creation with AI-powered branch naming and environment setup.

Streamlined fork of ccmanager by Kodai Kabasawa, optimized for rapid development workflow.

🚀 What Makes autocc Different?

autocc transforms workspace creation from a 6-step wizard into a single unified form, with Claude AI automatically handling branch naming and environment configuration.

Workflow Comparison

Before (ccmanager - 6 steps):

• Enter worktree path
• Select base branch
• Choose branch strategy
• Enter branch name
• Copy .claude settings?
• Copy session data?

After (autocc - 1 unified form):

Base Branch: main (configurable default)
Work Type:   feature/hotfix/lab
Description: add video storage checks

→ Claude creates: feature-video-storage-checks
→ Symlinks environment configs automatically
→ Launches you directly into interactive session

✨ Key Features

• 🎯 Unified Form: All inputs on one screen, tab to navigate
• 🤖 AI Branch Naming: Claude determines optimal branch names
• 🔗 Auto Environment Setup: Intelligent config file symlinking
• ⚡ Zero Context Switching: Land directly in your Claude session
• 📋 Work Type Categories: feature/hotfix/lab for better organization
• 🎨 Fresh Context: Each workspace starts with clean Claude history

📦 Installation

npm install -g autocc

🎯 Quick Start

# In any git repository
autocc

# Select "Create New Worktree"
# Fill the unified form:
#   1. Base branch: main
#   2. Work type: feature
#   3. Description: "add video storage checks"
# Press Enter

# autocc automatically:
#   ✓ Creates worktree with temp branch
#   ✓ Runs Claude in headless mode to determine branch name
#   ✓ Renames to: feature-video-storage-checks
#   ✓ Analyzes main repo and symlinks config files
#   ✓ Starts interactive Claude Code session
#   ✓ You're ready to work!

⚙️ Configuration

Create ~/.config/ccmanager/config.json:

{
  "worktree": {
    "defaultBaseBranch": "main",
    "autoDirectory": true,
    "autoDirectoryPattern": "../{branch}"
  }
}

Config Options

• defaultBaseBranch: Default base for new worktrees (e.g., "main", "develop")
• autoDirectory: Auto-generate worktree paths
• autoDirectoryPattern: Path pattern (supports {branch}, {project})

🎨 Work Types

• feature: New functionality (full-featured development)
• hotfix: Minor bug fixes and quick patches
• lab: Experimental work (keeps scope separate)

Branch Naming Convention

Format: {type}-{1-3-words}

Examples:

• ✅ feature-video-storage-checks
• ✅ hotfix-user-permissions-fix
• ✅ lab-collaboration-mobile
• ❌ feature-add-new-video-storage-system-with-checks (too long)

🔧 All ccmanager Features Included

autocc preserves all the powerful features from the original ccmanager:

• ✅ Multiple Claude Code sessions across worktrees
• ✅ Real-time session state tracking (idle/busy/waiting)
• ✅ Git status visualization with ahead/behind indicators
• ✅ Customizable keyboard shortcuts
• ✅ Multi-project support
• ✅ Devcontainer integration
• ✅ Command presets with fallback support
• ✅ Status change hooks for automation

🎬 How It Works

• Unified Form: One screen with base branch, work type, and description
• Headless Claude: Runs Claude with -p flag to analyze your request
• Intelligent Naming: Claude determines optimal branch name following conventions
• Environment Analysis: Identifies config files to symlink (.env, etc.)
• Branch Rename: Git renames temp branch to final name
• Verification: Confirms branch was renamed correctly
• Interactive Session: Launches full Claude Code session

📚 Original Features

For detailed documentation on session management, worktree operations, and advanced features, see the original ccmanager documentation.

🙏 Credits

Built on top of ccmanager by Kodai Kabasawa.

autocc adds workflow automation while preserving all the excellent session management features from the original project. Full credit to Kodai for creating such a solid foundation!

🤝 Contributing

This is a personal fork optimized for my workflow. For the actively maintained version with broader community support, please see ccmanager.

That said, if you find bugs specific to the autocc modifications, feel free to open an issue!

📄 License

MIT (same as ccmanager)

🔗 Links

• Original ccmanager: https://github.com/kbwo/ccmanager
• NPM Package: https://www.npmjs.com/package/autocc
• Your Issues: Update this after creating your GitHub repo