Claude Profile Manager (CPM)

Switch between multiple Claude Code profiles instantly — no re-authentication needed.

Claude Profile Manager is a fast, lightweight CLI, interactive TUI, VS Code Extension, and native Desktop GUI that lets developers manage multiple Claude Code accounts and switch between them in under 50ms using symlink-based credential isolation.

⚡ Install (One Command)

npm install -g claude-profiles-manager

Then run the interactive setup wizard:

cpm setup

The wizard will let you choose what to install:

• ✅ CLI (already installed)
• ☐ Terminal startup banner — shows active profile when you open terminal
• ☐ VS Code / Cursor Extension — switch profiles from the sidebar
• ☐ Desktop GUI App — native Linux desktop app (AppImage)
• ☐ Web Dashboard — auto-start local web UI on boot (systemd)

Or use it instantly without installing globally:

npx claude-profiles-manager list
npx claude-profiles-manager setup

🚀 Quick Start

1. Create a profile

cpm add work "Work account for client project"

2. Authenticate with Claude

cpm login-profile work

This opens browser authentication and saves credentials directly into the work profile.

3. Switch profiles

cpm switch work

4. Launch Claude Code

cpm launch

📖 All Commands

| Command | Description | |---|---| | cpm | Interactive TUI with arrow-key navigation | | cpm setup | Run interactive setup wizard | | cpm list | List all profiles with account details, plans, and usage stats | | cpm active | Print the currently active profile name | | cpm add <name> [description] | Create a new isolated profile | | cpm switch <name> | Switch active profile instantly (<50ms) | | cpm login-profile <name> | Authenticate a profile via browser OAuth | | cpm edit <name> [new-name] [desc] | Edit profile name or description | | cpm remove <name> | Delete a profile permanently | | cpm launch | Start claude interactive session | | cpm export <name> [output.zip] | Backup profile to zip archive | | cpm import <file.zip> [name] | Restore profile from zip archive | | cpm server [port] | Start web dashboard (default: 8080) | | cpm uninstall | Remove startup entries, services, desktop files | | cpm --version | Print version | | cpm --help | Show help |

🔧 How It Works & Context Preservation

CPM uses zero-overhead symlink swapping paired with shared project context:

1. Isolated Credentials: Each profile's .credentials.json and .claude.json are stored separately in ~/.claude-profile-manager/profiles/<profile-id>/.
2. Shared Session Context: projects/, plans/, and file-history/ are linked to a global shared directory (~/.claude-profile-manager/shared/).
3. Unbroken Claude Code Sessions: When Profile A hits a rate limit, switching profiles via cpm switch <profile-b> swaps authentication tokens while keeping your ongoing chat threads, prompts, subagents, and edit history 100% intact.
4. Seamless Resume: You can immediately continue running claude (or claude --resume) in your terminal or IDE under the new profile's quota without losing a single token or restarting your task!

🖥️ Available Interfaces

| Interface | Description | |---|---| | CLI | Direct terminal commands (cpm switch, cpm list, etc.) | | TUI | Full-screen interactive menu with arrow-key navigation | | VS Code Extension | Sidebar + status bar profile switcher | | Desktop GUI | Native Tauri app with glassmorphic dashboard | | Web Dashboard | Browser-based UI at http://localhost:8080 |

💡 Terminal Startup Integration

Show your active Claude profile every time you open a terminal:

# Add to ~/.bashrc or ~/.zshrc:
echo -e "\033[1;36m[Claude Profile]\033[0m Active: \033[1;32m$(cpm active 2>/dev/null || echo 'None')\033[0m"

Or let cpm setup configure this automatically!

📦 Share Profiles with Your Team

Export a profile to share with colleagues:

cpm export work work-profile.zip

Import on another machine:

cpm import work-profile.zip work

🗑️ Uninstall

Remove all CPM integrations (startup banner, systemd service, desktop entry):

cpm uninstall

Remove the CLI itself:

npm uninstall -g claude-profiles-manager

License

MIT