dr5hn/ccm

Profil dr5hn

Dernière activité source enregistrée: 8 août 2026 à 08:40

Catalogue SkillsMP mis à jour: 17 octobre 2026 à 00:09

skills collectés: 1

Étoiles GitHub: 29
Forks GitHub: 4

README du dépôt

Fichier source du README : README.md

Lire le README source

Afficher le README complet

``` ██████╗ ██████╗███╗ ███╗ ██╔════╝██╔════╝████╗ ████║ ██║ ██║ ██╔████╔██║ ██║ ██║ ██║╚██╔╝██║ ╚██████╗╚██████╗██║ ╚═╝ ██║ ╚═════╝ ╚═════╝╚═╝ ╚═╝ ``` [![GitHub stars](https://img.shields.io/github/stars/dr5hn/ccm?style=flat-square&color=38bdf8)](https://github.com/dr5hn/ccm/stargazers) [![License: MIT](https://img.shields.io/badge/license-MIT-green?style=flat-square)](LICENSE) [![Bash](https://img.shields.io/badge/bash-4.4%2B-blue?style=flat-square)](https://www.gnu.org/software/bash/) [![No Dependencies](https://img.shields.io/badge/dependencies-bash%20%2B%20jq-orange?style=flat-square)](#requirements) # CCM — Claude Code Manager > The power-user toolkit for Claude Code — manage accounts, sessions, environments, and health from one CLI. No Node, no Python, just bash. Works on macOS, Linux, and WSL. ## Why CCM? Claude Code has no built-in multi-account support ([10+ open issues](https://github.com/anthropics/claude-code/issues?q=is%3Aissue+is%3Aopen+multi+account)). Your `~/.claude` directory can grow to [500GB+ without warning](https://github.com/anthropics/claude-code/issues/26911). Your settings.json accumulates dead permission rules you don't know about. CCM is a single bash script that fixes all of this — and it's the only tool that auto-switches accounts when you `cd` into a project directory. ### How CCM compares | Feature | CCM | Cloak | aisw | Usage Monitor | Native CC | |---------|-----|-------|------|---------------|-----------| | Multi-account management | ✅ | ✅ | ✅ | ❌ | ❌ | | Per-terminal config isolation | ✅ | ✅ | ❌ | ❌ | ❌ | | Project-account bindings | ✅ | ✅ | ❌ | ❌ | ❌ | | Auto rate-limit switch | ✅ | ❌ | ❌ | ❌ | ❌ | | Per-account usage tracking | ✅ | ❌ | ❌ | ❌ | ❌ | | Session cleanup (9 targets) | ✅ | ❌ | ❌ | ❌ | Buggy | | Health checks (14 checks) | ✅ | ❌ | ❌ | ❌ | MCP only | | Environment snapshots | ✅ | ❌ | ❌ | ❌ | ❌ | | Permissions audit | ✅ | ❌ | ❌ | ❌ | ❌ | | Session archive/restore | ✅ | ❌ | ❌ | ❌ | ❌ | | .claudeignore generation | ✅ | ❌ | ❌ | ❌ | ❌ | | Orphan process cleanup | ✅ | ❌ | ❌ | ❌ | ❌ | | Zero runtime dependencies | ✅ (bash+jq) | ❌ (Node) | ❌ (Rust) | ❌ (Python) | N/A | ### Problems CCM Solves CCM addresses the most upvoted feature requests in [anthropics/claude-code](https://github.com/anthropics/claude-code/issues): - **Multi-account switching** — [#24963](https://github.com/anthropics/claude-code/issues/24963), [#22872](https://github.com/anthropics/claude-code/issues/22872), [#27359](https://github.com/anthropics/claude-code/issues/27359), [#37743](https://github.com/anthropics/claude-code/issues/37743) (100+ combined upvotes) - **Session cleanup** — [#42077](https://github.com/anthropics/claude-code/issues/42077), [#35164](https://github.com/anthropics/claude-code/issues/35164), [#39540](https://github.com/anthropics/claude-code/issues/39540) (tmp can grow to 100GB+) - **Token usage tracking** — [#33978](https://github.com/anthropics/claude-code/issues/33978), [#42436](https://github.com/anthropics/claude-code/issues/42436) (10+ duplicate issues) - **Orphaned process cleanup** — [#33947](https://github.com/anthropics/claude-code/issues/33947), [#1935](https://github.com/anthropics/claude-code/issues/1935) (14+ consolidated issues) - **Permissions auditing** — [#32904](https://github.com/anthropics/claude-code/issues/32904) (session permissions non-auditable) - **.claudeignore generation** — [#30857](https://github.com/anthropics/claude-code/issues/30857) (requested, never built natively) <p align="center"> <img src="demos/05-hero.gif" alt="CCM Demo — account switching, health checks, cleanup" width="800"> </p> ## Features ### Account Management - **Multi-account switching** — add, remove, and switch between Claude Code accounts - **Account aliases** — friendly names like `work` or `personal` for quick access - **Account reorder** — rearrange account positions with automatic credential renaming - **Project bindings** — bind directories to accounts, auto-switch with `ccm switch` - **Shell hook** — `eval "$(ccm hook)"` auto-switches accounts when you `cd` into bound directories (zero per-cd overhead). Use `eval "$(ccm hook --isolated)"` for per-shell `CLAUDE_CONFIG_DIR` config isolation - **Switch history and undo** — track switches and revert instantly - **Health verification** — validate backup integrity for all accounts - **Export/Import** — backup and restore account configurations as portable archives - **Per-terminal config** — `ccm switch --isolated <account>` gives each terminal its own `CLAUDE_CONFIG_DIR` config and session history - **Profile management** — `ccm profiles list|sync|delete` for isolated profile directories > **Note on credentials.** `--isolated` separates config and session history, but **not credentials**. > Claude Code reads credentials from the macOS Keychain (ignoring `CLAUDE_CONFIG_DIR`) and from > `~/.claude/.credentials.json` on Linux/WSL, so concurrent sessions still share one token and a > refresh in one can invalidate the other. This is an upstream limitation, tracked in > [anthropics/claude-code#70697](https://github.com/anthropics/claude-code/issues/70697) and > [anthropics/claude-code#47661](https://github.com/anthropics/claude-code/issues/47661). ### Session Management - **Session listing** — view all Claude Code project sessions with size and age - **Session search** — full-text search across all conversation history - **Session info** — inspect sessions for a specific project directory - **Session relocation** — move sessions when a project folder is relocated - **Session cleanup** — remove orphaned sessions for projects that no longer exist - **Session archive** — compress old sessions to tar.gz instead of deleting - **Session restore** — restore from archived sessions ### Statusline - **Smart status bar** — shows context %, tokens, session cost, duration, burn rate, rate limits, directory, branch, and version at the bottom of Claude Code - **Adaptive display** — 2 lines for single-account, 3 lines for multi-account. Rate limits only for Pro/Max users - **Color-coded warnings** — context bar and rate limits change color as you approach limits. Compact warning at 80%+ - **Standalone install** — share with your team without CCM: `curl -fsSL .../statusline.sh | bash` ### Monitoring & Recovery - **Rate limit watcher** — `ccm watch --threshold N [--auto]` monitors rate limits and auto-switches accounts - **Error recovery** — `ccm recover` detects and fixes inconsistent credential state - **Setup wizard** — `ccm setup` interactive first-run onboarding ### Project Setup - **Init** — auto-generate `.claudeignore` based on detected project type (Node, Python, Go, Rust, Java, Ruby, PHP, .NET, Dart, Swift) ### Environment Snapshots - **Snapshot capture** — save current Claude Code environment (settings, MCP config, CLAUDE.md) - **Snapshot restore** — roll back to a previous environment configuration - **MCP audit** — flag MCP servers with CLI alternatives to save tokens ### Health & Maintenance - **Doctor** — 14 health checks: stale locks, log bloat, cache, telemetry, todos, paste cache, file history, shell snapshots, orphaned sessions, total disk size, tmp files, orphaned processes, hook async config - **Clean** — targeted cleanup for debug logs, telemetry, todos, cache, history, tmp output files, orphaned processes - **Permissions audit** — find duplicate, contradictory, and dead permission rules in settings.json - **Auto-fix** — `ccm doctor --fix` and `ccm permissions audit --fix` resolve safe issues automatically ### Usage Statistics - **Summary** — total projects, sessions, disk usage at a glance - **Top projects** — rank projects by disk usage to identify space hogs - **Token history** — per-project and per-day token usage breakdown from session JSONL files - **Per-account dashboard** — `ccm usage dashboard` tracks token usage per account - **Per-session cost** — `ccm usage sessions` shows token count and estimated cost per session with model-specific pricing - **Session summaries** — `ccm session summary` shows topic, tools used, and files modified per session - **Account comparison** — `ccm usage compare` side-by-side view ## Installation ```bash curl -fsSL https://raw.githubusercontent.com/dr5hn/ccm/main/install.sh | bash ``` Installs to `~/.ccm/bin/` and adds to your `$PATH` automatically. No `sudo` required. After install, restart your terminal (or `source ~/.zshrc`) and run: ```bash ccm version ``` ### Install via Homebrew ```bash brew tap dr5hn/tap brew install ccm ``` ### Install via npm ```bash npm install -g @dr5hn/ccm ``` Or run without installing: ```bash npx @dr5hn/ccm version ``` ### Install as a Skill If you use Claude Code (or Cursor, Codex, Gemini CLI, etc.): ```bash npx skills add dr5hn/ccm@ccm ``` This teaches your AI agent about all CCM commands and workflows. ### Manual Install ```bash mkdir -p ~/.ccm/bin && curl -fsSL https://raw.githubusercontent.com/dr5hn/ccm/main/ccm.sh -o ~/.ccm/bin/ccm && chmod +x ~/.ccm/bin/ccm ``` Then add to your shell profile (`~/.zshrc`, `~/.bashrc`, etc.): ```bash export PATH="$HOME/.ccm/bin:$PATH" ``` ### Update Re-run the installer to update to the latest version: ```bash curl -fsSL https://raw.githubusercontent.com/dr5hn/ccm/main/install.sh | bash ``` Or manually: ```bash curl -fsSL https://raw.githubusercontent.com/dr5hn/ccm/main/ccm.sh -o ~/.ccm/bin/ccm && chmod +x ~/.ccm/bin/ccm ``` Check your current version with `ccm version`. ### Requirements - Bash 4.4+ - `jq` — install with `brew install jq` (macOS) or `sudo apt install jq` (Linux) ## Quick Start ```bash # First-run setup wizard ccm setup # Or add accounts manually ccm add ccm alias 1 personal # Log into another account, then add it too ccm add ccm alias 2 work # Switch between accounts ccm switch work ccm switch personal ccm undo # revert last switch ``` After each switch, restart Claude Code to use the new authentication. ## Command Reference ### Account Management ```bash ccm setup # Interactive first-run setup wizard ccm add # Add current Claude Code account ccm remove <id> # Remove by number, email, or alias ccm switch [id] # Switch to next, specific, or project-bound account ccm switch --isolated <id> # Switch with isolated CLAUDE_CONFIG_DIR (config + history) ccm undo # Revert to the previous account ccm list # List all managed accounts and bindings ccm alias <id> <name> # Set a friendly alias ccm reorder <from> <to> # Reorder account positions ccm bind [path] <account> # Bind project directory to an account ccm unbind [path] # Remove project binding ccm bind list # Show all project bindings ccm hook # Output shell hook for auto-switch on cd (global mode) ccm hook --isolated # Hook that sets CLAUDE_CONFIG_DIR per-shell (config isolation) ccm verify [id] # Verify backup integrity ccm history # View switch history ccm export <path> # Export accounts to archive ccm import <path> # Import from archive ccm profiles list # List isolated profile directories ccm profiles sync <id> # Sync profile with main config ccm profiles delete <id> # Delete an isolated profile ccm recover # Detect and fix inconsistent credential state ccm codex status # Show Codex CLI rate limits, plan, and token usage ``` ### Session Management ```bash ccm session list # List all project sessions ccm session info <project-path> # Show sessions for a project (use . for cwd) ccm session summary [path] [--limit N] # What happened in each session (topic, tools, files) ccm session search <query> [--limit N] # Full-text search across all sessions ccm session relocate <old> <new> # Update sessions after moving a project ccm session clean [--dry-run] # Remove orphaned sessions ccm session archive <project-path> # Compress old sessions to tar.gz ccm session restore <archive> # Restore from archived session ccm session archives # List all archived sessions ``` ### Monitoring & Recovery ```bash ccm watch --threshold N # Monitor rate limits, alert at threshold ccm watch --threshold N --auto # Auto-switch accounts on rate limit ccm recover # Detect and fix inconsistent credential state ccm setup # Interactive first-run onboarding ``` ### Statusline ```bash ccm statusline # Install statusline in Claude Code ccm statusline install # Same as above ccm statusline remove # Remove statusline ``` Or share with your team (no CCM needed): ```bash curl -fsSL https://raw.githubusercontent.com/dr5hn/ccm/main/statusline.sh | bash ``` ### Project Setup ```bash ccm init # Generate .claudeignore for this project ccm init --force # Overwrite existing .claudeignore ``` ### Environment Snapshots ```bash ccm env snapshot [name] # Capture environment state ccm env restore <name> [--force] # Restore a saved snapshot ccm env list # List all snapshots ccm env delete <name> # Delete a snapshot ccm env audit # Audit MCP servers for token efficiency ``` ### Health & Maintenance ```bash ccm doctor # 14 health checks ccm doctor --fix # Auto-fix safe issues ccm clean debug [--days N] # Clean debug logs (default: 30 days) ccm clean telemetry # Remove telemetry data ccm clean todos [--days N] # Remove old todo files ccm clean history [--keep N] # Trim history (default: keep 1000) ccm clean tmp [--days N] # Clean orphaned tmp output files (default: 1 day) ccm clean processes # Kill orphaned Claude subagent processes ccm clean cache # Clean plugin cache ccm clean all [--dry-run] # Clean everything safe ccm permissions audit # Scan for duplicate/dead permission rules ccm permissions audit --fix # Auto-remove duplicates ``` ### Usage Statistics ```bash ccm usage summary # Usage overview ccm usage top [--count N] # Top projects by disk usage ccm usage history [--days N] # Token usage by project and day ccm usage history --project <path> # Token usage for a specific project ccm usage sessions # Per-session tokens and estimated cost ccm usage sessions --project <path> # Sessions for a specific project ccm usage dashboard # Per-account token usage dashboard ccm usage compare # Side-by-side account comparison ``` ### Global Options ```bash ccm help [module] # Show help (launch, init, permissions, doctor, etc.) ccm version # Show version ccm --no-color <command> # Disable colored output ``` ## Examples ### Daily Account Switching <img src="demos/01-list-and-switch.gif" alt="CCM account switching demo" width="700"> ```bash ccm switch work # switch to work account ccm switch personal # switch back ccm undo # oops, revert ccm history # see recent switches ``` ### Project-Specific Accounts ```bash ccm bind ~/work/project work # bind project to work account ccm bind . personal # bind current directory ccm bind list # show all bindings # Now `ccm switch` in a bound directory auto-switches # Auto-switch on cd (add to ~/.zshrc or ~/.bashrc): eval "$(ccm hook)" # cd ~/work/project → auto-switches to work account (rewrites global creds) # Recommended for concurrent terminals — each shell gets its own isolated profile: eval "$(ccm hook --isolated)" # cd ~/work/project → exports CLAUDE_CONFIG_DIR in this shell only, no global rewrite ``` ### New Project Setup ```bash ccm init # auto-generate .claudeignore ccm permissions audit # check for dead/duplicate permission rules ``` ### Token Usage Analytics ```bash 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 ```bash ccm session search "error handling" # search across all sessions ccm session search "API" --limit 5 # limit results ``` ### Disk Cleanup <img src="demos/02-doctor.gif" alt="CCM doctor health check demo" width="700"> ```bash ccm doctor # 14 health 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 ``` ### Environment Snapshots ```bash ccm env snapshot before-experiment # ... make risky config changes ... ccm env restore before-experiment # roll back if needed ``` ### Moving a Project ```bash # After moving ~/old-project to ~/new-location/project: ccm session relocate ~/old-project ~/new-location/project ``` ## Ecosystem CCM focuses on account management, operational health, and environment portability. It works great alongside other Claude Code tools: | Tool | What it does | Stars | |------|-------------|-------| | [ccusage](https://github.com/ryoppippi/ccusage) | Detailed token analytics and cost tracking | 12k+ | | [ccstatusline](https://github.com/sirmalloc/ccstatusline) | Rich interactive status bar with themes | 6k+ | | [ccmanager](https://github.com/kbwo/ccmanager) | Multi-agent session orchestration | 900+ | **What only CCM does:** - Per-terminal config + history via isolated CLAUDE_CONFIG_DIR profiles - Auto rate-limit switching across accounts - Per-account usage tracking and comparison dashboard - Project-to-account bindings with shell hook auto-switch - Session archival and restore - Permissions audit with `--fix` for settings.json - `.claudeignore` generation from project type detection - Environment snapshots (settings.json + MCP config + CLAUDE.md as a unit) - First-run setup wizard for guided onboarding - Zero runtime dependencies — single bash script, no package managers needed ## Security CCM handles OAuth credentials — security is taken seriously: - **No `eval`** — all external data (JSON, user input) is processed with safe parsing patterns (`IFS read`, `jq @tsv`), never interpreted as shell code - **Atomic writes with restricted permissions** — credential and config files are created with `umask 077` (owner-only from the moment of creation), then atomically moved into place - **Input validation at every boundary** — account numbers validated as numeric, emails validated against regex, snapshot names restricted to `[a-zA-Z0-9._-]`, identifiers bounded to 255 chars - **Path traversal protection** — all parameters used in file path construction are validated before use - **macOS Keychain integration** — credentials stored in the system keychain, not on disk - **Safe cleanup patterns** — `trap` and `rm` commands use proper quoting and `--` end-of-options markers ## How It Works CCM stores account data separately from Claude Code: - **macOS**: Credentials in Keychain, OAuth config in `~/.claude-switch-backup/` - **Linux/WSL**: Both stored in `~/.claude-switch-backup/` with restricted permissions (owner-only via umask 077) When switching accounts, CCM backs up the current account, restores the target, and updates Claude Code's auth files. Sessions, settings, and preferences are preserved. ### Storage Locations | Data | Location | |------|----------| | Account configs & credentials | `~/.claude-switch-backup/` | | Environment snapshots | `~/.claude-switch-backup/snapshots/` | | Project sessions | `~/.claude/projects/` | | Isolated profiles | `~/.claude-switch-backup/profiles/` | | Session archives | `~/.claude-switch-backup/archives/` | | Rate limit state | `~/.claude-switch-backup/rate-limits.json` | | CCM binary | `~/.ccm/bin/ccm` | ## Troubleshooting ### Switch fails or account not recognized ```bash ccm list # check managed accounts ccm verify # validate backups ccm undo # revert to previous ``` ### Claude Code doesn't use the new account after switch Restart Claude Code after every switch. Verify with `ccm list`. ### Disk usage is high ```bash ccm doctor # full health check ccm usage top # find space hogs ccm session clean # remove orphaned sessions ccm clean all # clean logs, telemetry, cache ``` ### Cannot add an account - Ensure you are logged into Claude Code first - Verify `jq` is installed: `jq --version` - Check write permissions to your home directory ## Uninstall ```bash # Remove the binary rm -f ~/.ccm/bin/ccm # Remove the PATH entry from your shell profile # (delete the "# CCM" lines from ~/.zshrc or ~/.bashrc) # Optionally remove backup data rm -rf ~/.claude-switch-backup ``` Your current Claude Code login will remain active. ## Security - Credentials stored in macOS Keychain or files with 600 permissions - Snapshot capture strips tokens/credentials from config files - All inputs validated and sanitized before processing - No use of `eval` or unsanitized shell calls ## Disclaimer This is a personal weekend project and is not affiliated with, endorsed by, or associated with Anthropic. "Claude Code" is a product of Anthropic. This tool manages local configuration files and credentials on your machine — it does not interact with Anthropic's servers or APIs directly. Use at your own risk. Always back up your credentials before using any account management tool. ## License MIT License — see [LICENSE](LICENSE) for details.

Chargement du README du dépôt…

Skills dans ce dépôt

Autres occupations informatiques

1 catégories métier · 100% classifié

skill

métier

description

mis à jour

ccm

Autres occupations informatiques

Claude Code Manager — manage accounts, sessions, environments, and optimize token usage. Use when the user mentions switching Claude accounts, cleaning up sessions, environment snapshots, disk usage, token optimization, Claude Code health check, orphaned…

Langue du texte source : anglais

2026-08-08

Affichage de 1 skills collectés sur 1.

Installer avec un assistant IA

Copiez ce prompt dans l’assistant IA que vous utilisez.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/dr5hn/ccm.