autocc

autocc

Stay in flow. AI-powered workspace creation that eliminates context switching and decision fatigue.

Forked from ccmanager by Kodai Kabasawa • Inspired by conductor.build

📦 Installation

npm install -g autocc

⚡ Quick Start

cd your-git-repo
autocc

Press N to create a new worktree, answer 3 progressive questions:

• Base branch: develop
• Work type: feature/hotfix/maintenance/lab
• Description: add video storage checks

autocc creates .autocc/feature-video-storage-checks and you're ready to work!

✨ Key Features

• 🤖 AI Branch Naming - Claude suggests semantic branch names from your description
• 📁 Smart Organization - All worktrees in .autocc/ folder, auto-updates .gitignore
• 🔗 Auto Env Symlinking - .env files automatically symlinked from main worktree
• 📝 Context Injection - Work description prepended to claude.md for Claude
• 🎨 Sectioned Menu - Organized by type (Features/Hotfixes/Maintenance/Lab)
• 🏷️ Visual Indicators - [new] badges, session states, git status
• ⚡ Progressive Questions - One question at a time, no cognitive overload
• 🔊 Verbose Mode - Debug with --verbose flag

🗺️ Roadmap

Near Term

• 🔀 Claude-Powered Merging - AI resolves merge conflicts intelligently
• 🎯 Planning Mode Indicator - Visual indicator for worktrees in Claude planning mode
• 📊 Project Summary Dashboard - Overview of all work in progress across worktrees
• 🏷️ Custom Worktree Types - Define your own types beyond feature/hotfix/maintenance/lab
• 🔔 Background Notifications - Optional desktop notifications for session state changes

Future

• 💎 Premium Tier - Internal development tools + knowledge base management
  • Team knowledge base creation and curation
  • API for integration with external platforms
  • Advanced analytics and insights
  • Priority support

📚 Documentation

• Getting Started - Philosophy, workflow comparison, quick start guide
• Features - Complete feature documentation with examples
• Configuration - All configuration options and customization
• Architecture - Technical details for contributors
• CLAUDE.md - Comprehensive development guide with Effect-ts patterns

🎨 Work Types

Type	Purpose	Example
feature	New functionality	feature-video-storage-checks
hotfix	Quick bug fixes	hotfix-auth-token-expire
maintenance	Refactoring & improvements	maintenance-collab-refactor
lab	Experimental work	lab-new-architecture

🔧 Configuration

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

{
  "worktree": {
    "defaultBaseBranch": "develop",
    "symlinkEnvFiles": true
  }
}

See Configuration Guide for all options.

🙏 Credits

• ccmanager by Kodai Kabasawa - Foundation for session management
• conductor.build - Inspiration for momentum-focused design

📄 License

MIT

🔗 Links

• GitHub: https://github.com/haseebnqureshi/autocc
• npm: https://www.npmjs.com/package/autocc
• Issues: https://github.com/haseebnqureshi/autocc/issues