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

source ~/.zshrc

2. Command Reference

Account Management

ccm add

ccm remove <id>

ccm switch [id]

ccm undo

ccm list

ccm alias <id> <name>

ccm alias 1 work

ccm reorder <from> <to>

ccm bind [path] <account>

ccm unbind [path]

ccm bind list

ccm hook

ccm hook --isolated

CLAUDE_CONFIG_DIR

ccm verify [id]

ccm history

ccm export <path>

ccm import <path>

Session Management

ccm session list

ccm session info <project-path>

ccm session search <query> [--limit N]

ccm session relocate <old> <new>

ccm session summary [path] [--limit N]

ccm session clean [--dry-run]

ccm session archive [--older-than Nd]

ccm session restore <archive>

ccm session archives

Environment Snapshots

ccm env snapshot [name]

ccm env restore <name> [--force]

ccm env list

ccm env delete <name>

ccm env audit

Usage Stats

ccm usage summary

ccm usage top [--count N]

ccm usage history [--days N] [--project <path>]

ccm usage sessions [--project <path>] [--days N]

ccm usage dashboard [--days N] [--account <name>]

ccm usage compare

Health & Maintenance

ccm doctor

ccm doctor --fix

ccm clean debug [--days N]

ccm clean telemetry

ccm clean todos [--days N]

ccm clean history [--keep N]

ccm clean tmp [--days N]

ccm clean processes

ccm clean cache

ccm clean all [--dry-run]

Profiles & Monitoring

ccm switch --isolated <account>

ccm profiles list

ccm profiles sync <name>

ccm profiles delete <name>

ccm watch --threshold N [--auto]

ccm watch stop

ccm watch status

ccm recover

ccm setup

Project Setup

ccm init

ccm init --force

Statusline

ccm statusline

ccm statusline install

ccm statusline remove

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

ccm permissions audit

ccm permissions audit --fix

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; concurrent terminals stay on
# their own accounts without fighting over global credentials.

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
• Use

  ccm switch --isolated

  for concurrent sessions in different terminals
• 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)