Ccm

CCM — Claude Code Manager

The power-user toolkit for Claude Code. Manages accounts, sessions, environments, and usage from the terminal.

GitHub: https://github.com/dr5hn/ccm

1. Installation Check

Before running any CCM command, verify it's installed:

ccm version

If not found, install it:

curl -fsSL https://raw.githubusercontent.com/dr5hn/ccm/main/install.sh | bash

This installs to ~/.ccm/bin/ccm — no sudo required. After install, the user needs to restart their terminal or source ~/.zshrc.

2. Command Reference

Account Management

Session Management

Environment Snapshots

Usage Stats

Health & Maintenance

Profiles & Monitoring

Project Setup

Statusline

Standalone install (no CCM needed): curl -fsSL https://raw.githubusercontent.com/dr5hn/ccm/main/statusline.sh | bash

Shows: context bar, tokens, session cost, duration, burn rate, 5hr/7d rate limits, directory, branch, version.

Permission Rules

3. Common Workflows

First-time setup

# Install CCM
curl -fsSL https://raw.githubusercontent.com/dr5hn/ccm/main/install.sh | bash
source ~/.zshrc

# Run the setup wizard (adds accounts, sets aliases, installs statusline)
ccm setup

Daily account switching

ccm switch work        # switch to work account
ccm switch personal    # switch back
ccm undo               # revert last switch

Project-specific accounts

ccm bind ~/work/project work       # bind project to work account
ccm bind ~/personal/side-project personal
ccm bind list                      # show all bindings
# Now `ccm switch` in a bound directory auto-switches to the right account

Auto-switch on cd (shell hook)

# Add to ~/.zshrc or ~/.bashrc — pick ONE mode:

# Global mode (simple, rewrites ~/.claude creds on each cd):
eval "$(ccm hook)"

# Isolated mode (recommended when you use multiple terminals at once):
eval "$(ccm hook --isolated)"
# Sets CLAUDE_CONFIG_DIR in THIS shell only, so each terminal keeps its own
# config and session history. NOTE: credentials are NOT isolated — Claude Code
# reads those from the macOS Keychain / ~/.claude/.credentials.json regardless
# of CLAUDE_CONFIG_DIR (upstream: anthropics/claude-code#70697).

cd ~/work/project    # → auto-switches to work account
cd ~/personal/side   # → auto-switches to personal account

Token usage analytics

ccm usage history                  # last 7 days, all projects
ccm usage history --days 30        # last 30 days
ccm usage history --project .      # current project only

Search conversation history

ccm session search "error handling"       # find across all sessions
ccm session search "API" --limit 5        # limit results

Concurrent sessions

ccm switch --isolated work      # isolated profile for terminal 1
# In another terminal:
ccm switch --isolated personal  # isolated profile for terminal 2
ccm profiles list               # see all active profiles
ccm profiles sync work          # sync latest settings to a profile

Rate limit monitoring

ccm watch --threshold 80        # alert when rate limit hits 80%
ccm watch --threshold 80 --auto # auto-switch accounts at threshold
ccm watch status                # check watcher state
ccm watch stop                  # stop monitoring

Install statusline

ccm statusline         # install — shows cost, tokens, rate limits, branch
ccm statusline remove  # uninstall

New project setup

ccm init               # auto-generate .claudeignore
ccm permissions audit  # check for dead/duplicate permission rules

Disk cleanup

ccm doctor             # see what's eating space (13 checks)
ccm doctor --fix       # auto-fix safe issues
ccm clean tmp          # clean orphaned tmp output files
ccm clean processes    # kill leaked subagent processes
ccm clean all --dry-run # preview all cleanups

Moving a project folder

# After moving ~/old-project to ~/new-location/project:
ccm session relocate ~/old-project ~/new-location/project

Before risky config changes

ccm env snapshot before-experiment
# ... make changes ...
ccm env restore before-experiment  # if things break

4. Important Notes

• After switching accounts, restart Claude Code for changes to take effect
• ccm doctor --fix only removes data older than 30 days — recent data is never touched
• Environment snapshots do NOT capture credentials — only configuration
• ccm switch --isolated isolates config and session history per terminal, but NOT credentials — that is blocked upstream (anthropics/claude-code#70697)
• ccm codex status is read-only: it parses Codex's own session rollout files and never writes to ~/.codex
• Install statusline before using ccm watch (provides rate limit data)
• Session relocate updates both session files and memory references
• Project bindings are auto-cleaned when an account is removed
• Orphaned process detection is macOS only (ppid=1 unreliable on Linux)