CCManager is a TUI application designed to manage multiple AI coding assistant sessions, specifically Claude Code and Gemini CLI, across different Git worktrees. It targets developers who need to efficiently switch between and monitor various AI-assisted coding tasks without relying on tmux, offering a self-contained and intuitive interface for enhanced productivity.

How It Works

CCManager provides a centralized TUI for managing AI assistant sessions, allowing users to run multiple instances in parallel across Git worktrees. It features visual status indicators (busy, waiting, idle) for each session, enabling real-time monitoring of the AI's state. The application supports seamless switching between sessions, copying conversation context between worktrees, and offers configurable keyboard shortcuts and command presets with fallback options for reliability.

Quick Start & Requirements

• Install: npm install -g ccmanager or npx ccmanager for direct execution.
• Prerequisites: Node.js. For Gemini CLI support, install google-gemini/gemini-cli.
• Configuration: Customize commands, arguments, and shortcuts via the UI or ~/.config/ccmanager/config.json.
• Docs: docs/command-config.md, docs/state-hooks.md, docs/worktree-auto-directory.md, docs/devcontainer.md, docs/git-worktree-config.md.

Highlighted Details

• No tmux dependency, self-contained and works out-of-the-box.
• Real-time session monitoring with visual status indicators.
• Supports copying Claude Code session data between worktrees to maintain conversation context.
• Devcontainer integration for sandboxed development environments.

Maintenance & Community

No specific contributors, sponsorships, or community links (Discord/Slack) are mentioned in the README.

Licensing & Compatibility

The README does not explicitly state a license.

Limitations & Caveats

The project does not specify licensing, which may impact commercial use or integration with closed-source projects. Community support channels are not detailed.