cpm

Claude Profile Manager — run multiple Claude Code accounts side-by-side
with isolated credentials, shared config, and zero overhead.

Why?

You have a personal Claude subscription and a company one. Or a Vertex AI setup. Or three clients. Every time you switch, you re-login, lose context, or mix credentials.

cpm gives each account its own claude-<name> command. Run them in parallel, auto-switch per project, never re-login.

claude-personal     # Personal Anthropic subscription
claude-work         # Company team account
claude-vertex       # Company via Google Cloud Vertex AI

How it works

flowchart LR
    A["config.toml"] --> B["cpm install"]
    B --> C["~/.claude-profiles/personal/"]
    B --> D["~/.claude-profiles/work/"]
    B --> E["bin_dir/claude-personal"]
    B --> F["bin_dir/claude-work"]
    C --> G["claude-personal"]
    D --> H["claude-work"]

    style A fill:#7c3aed,color:#fff
    style B fill:#7c3aed,color:#fff
    style G fill:#059669,color:#fff
    style H fill:#059669,color:#fff

Each profile gets an isolated CLAUDE_CONFIG_DIR with its own credentials, while sharing commands, skills, plugins, and projects via symlinks (Unix) or junctions (Windows):

~/.claude-profiles/
├── config.toml
├── personal/
│   ├── settings.json        # Copied (mutable)
│   ├── CLAUDE.md            # Copied (mutable)
│   ├── commands/ -> ~/.claude/commands/   # Linked
│   ├── skills/   -> ~/.claude/skills/     # Linked
│   ├── plugins/  -> ~/.claude/plugins/    # Linked
│   ├── projects/ -> ~/.claude/projects/   # Linked
│   ├── .credentials.json    # Per-profile (created by Claude)
│   └── .claude.json         # Per-profile (seeded by cpm)
└── work/
    └── ...

Install

One-liners on every platform:

# macOS / Linux
brew install silicondawn/tap/cpm

# Windows (PowerShell 7+)
scoop bucket add cpm https://github.com/silicondawn/cpm
scoop install cpm

That's it. After install:

cpm onboard       # interactive TUI — pick OAuth or API-key mode per profile
cpm install       # write profile dirs + claude-<name> wrappers
claude-<name>     # run Claude Code with that profile's env

Other install methods

GitHub Releases (manual)

Download the binary archive from Releases and unpack to a directory on your PATH:

# macOS (Intel / Apple Silicon via Rosetta)
curl -L https://github.com/silicondawn/cpm/releases/latest/download/cpm_darwin_amd64.tar.gz \
  | tar -xz -C ~/.local/bin/ cpm

# Linux x86_64
curl -L https://github.com/silicondawn/cpm/releases/latest/download/cpm_linux_amd64.tar.gz \
  | tar -xz -C ~/.local/bin/ cpm

chmod +x ~/.local/bin/cpm

For Windows manual install, grab cpm_windows_amd64.zip from Releases, extract cpm.exe, and drop it somewhere on PATH (e.g. $env:LOCALAPPDATA\cpm\bin).

From source

git clone https://github.com/silicondawn/cpm.git
cd cpm
go install .

Windows notes

Requires PowerShell 7+ (pwsh). Install via winget install Microsoft.PowerShell if missing. Windows PowerShell 5.1 is not supported.
Profile-shared directories use junctions, so no Administrator / Developer Mode required.
cpm.exe self-upgrade uses a rename-old / rename-new trick — no admin needed.

Quick start

# 1. Create config interactively (TUI form)
cpm onboard

# 2. Install profiles + wrapper scripts
cpm install

# 3. Authenticate each profile (first time only — OAuth in browser)
claude-personal
claude-work

Windows note: after cpm install, run any claude-<name> from a new PowerShell session. The wrapper handles env setup automatically. Add the auto-switch hook to $PROFILE:

Invoke-Expression (& cpm hook | Out-String)

Per-project profiles (like `.nvmrc`)

flowchart LR
    A["cd ~/Work/project"] --> B["shell hook"]
    B --> C{".claude-profile?"}
    C -->|"found: work"| D["auto-switch to work"]
    C -->|"not found"| E["unset profile"]

    style A fill:#7c3aed,color:#fff
    style D fill:#059669,color:#fff

Link a profile to any project directory:

# Set profile for this project
cd ~/Work/company-project
cpm link work

# Auto-switch on cd (add to .zshrc / .bashrc once)
eval "$(cpm hook)"

# Or on Windows ($PROFILE):
Invoke-Expression (& cpm hook | Out-String)

# Now every time you cd into this project, the profile switches.

The .claude-profile file is automatically added to .gitignore.

Commands

Command	Description
`cpm install`	Create profile directories and wrapper scripts
`cpm install --sync`	Re-sync mutable files from `~/.claude`
`cpm install --sync --force`	Force overwrite diverged files
`cpm list`	List all profiles with status
`cpm which`	Show active profile (from env or `.claude-profile`)
`cpm status`	Check sync divergence
`cpm doctor`	Diagnose issues (broken symlinks, expired creds, ...)
`cpm credentials`	Show OAuth token status for all profiles
`cpm use <profile>`	Switch shell — Unix: `eval "$(cpm use work)"`; PowerShell: `Invoke-Expression (& cpm use work \| Out-String)`
`cpm run <profile> [args]`	One-shot: `cpm run work -p "explain this"`
`cpm link <profile>`	Create `.claude-profile` in current dir
`cpm unlink`	Remove `.claude-profile`
`cpm hook`	Print shell hook for auto-switch
`cpm direnv <profile>`	Print `.envrc` snippet
`cpm clone <src> <dst>`	Clone profile (without credentials)
`cpm onboard`	Interactive TUI setup wizard (alias: `cpm init`)
`cpm version`	Show version + check for updates
`cpm upgrade`	Self-update from GitHub Releases
`cpm cloud init [--remote <url>]`	Initialize cloud sync repo
`cpm cloud push [-m "msg"]`	Push local settings to cloud
`cpm cloud pull [--dry-run]`	Pull settings from cloud
`cpm cloud status`	Show cloud sync status
`cpm cloud remote <url>`	Set/update git remote URL

Cloud sync

Sync your Claude Code settings (plugins, skills, commands, settings.json) across machines via a private git repository.

# On your first machine — initialize and push
cpm cloud init --remote git@github.com:you/claude-settings.git
cpm cloud push

# On another machine — clone and pull
cpm cloud init --remote git@github.com:you/claude-settings.git
# Files are automatically distributed on clone

# Later — sync changes
cpm cloud push   # from the machine where you changed settings
cpm cloud pull   # on the other machine

What gets synced

Synced	Not synced
`settings.json`, `settings.local.json`	Credentials (`.credentials.json`)
`CLAUDE.md`	Sessions, caches
`commands/`, `agents/`	`projects/` (cache, ~2 GB)
`plugins/installed_plugins.json`	Telemetry
`plugins/known_marketplaces.json`
`.skill-lock.json`
cpm `config.toml`

Exclude files from sync

[cloud]
remote = "git@github.com:you/claude-settings.git"
exclude = ["CLAUDE.md", "commands/"]

Configuration

`~/.claude-profiles/config.toml`

source_dir = "~/.claude"
# bin_dir default per platform:
#   Unix:    ~/.local/bin
#   Windows: ~/scoop/shims  (if cpm was installed via scoop)
#            %LOCALAPPDATA%\cpm\bin (otherwise)
# bin_dir = "/custom/path"

[profiles.personal]
description = "Personal Anthropic account"

[profiles.work]
description = "Company team subscription"
model = "sonnet"
add_dirs = ["~/Work/company"]

[profiles.work.attribution]
commit = "Co-Authored-By: Claude <noreply@anthropic.com>"
pr = "Generated with [Claude Code](https://claude.ai/code)"

[profiles.vertex]
description = "Company via Vertex AI"
add_dirs = ["~/Work/company"]

[profiles.vertex.env]
CLAUDE_CODE_USE_VERTEX = "1"
ANTHROPIC_VERTEX_PROJECT_ID = "your-project-id"
CLOUD_ML_REGION = "europe-west1"

Config reference

Field	Default	Description
`source_dir`	`~/.claude`	Source for shared config
`bin_dir`	platform-aware (see above)	Where wrapper scripts are installed
`profiles.<name>.description`		Human-readable description
`profiles.<name>.model`		Default model (`sonnet`, `opus`)
`profiles.<name>.add_dirs`		Extra dirs passed via `--add-dir`
`profiles.<name>.env`		Environment variables
`profiles.<name>.attribution.commit`		Git commit attribution text
`profiles.<name>.attribution.pr`		PR description attribution text
`cloud.remote`		Git remote URL for cloud sync
`cloud.auto_push`	`false`	Auto-push on `cpm install`
`cloud.exclude`	`[]`	Files/dirs to exclude from sync

Shared file handling

Type	Files	Behavior
Copied	`settings.json`, `settings.local.json`, `CLAUDE.md`	Copied on first install. `--sync` to refresh.
Linked	`commands/`, `skills/`, `agents/`, `plugins/`, `projects/`	Shared across all profiles via symlink (Unix) or junction (Windows)
Seeded	`.claude.json`	Onboarding flags + MCP servers copied from source so the profile skips first-run wizard
Per-profile	`.credentials.json`, `teams/`	Created by Claude on first OAuth

Shell integration

Prompt (PS1 / Starship)

Show active profile in your terminal prompt:

# .zshrc — simple
PROMPT='$(cpm prompt)> '

# Starship — custom command
[custom.claude]
command = "cpm prompt"
when = "test -n \"$CLAUDE_PROFILE\""
format = "[$output]($style) "
style = "purple"

PowerShell prompt — see cpm hook output, which preserves your existing prompt function.

direnv

# Generate .envrc for a project (Unix)
cpm direnv work >> ~/Work/company-project/.envrc
direnv allow ~/Work/company-project

On Windows cpm direnv emits a $env: snippet you can Invoke-Expression from your .envrc.ps1 or PowerShell-aware loader.

Upgrading

# Self-update (downloads matching release binary)
cpm upgrade

# Via Scoop (Windows)
scoop update cpm

# Via Homebrew (macOS / Linux)
brew upgrade cpm

Platform support

macOS, Linux, or Windows 10/11 (PowerShell 7+ for the Windows version — Windows PowerShell 5.1 is not supported)
Claude Code installed and on PATH
bin_dir on PATH (the default already is on Windows when installed via scoop; on Unix you may need to add ~/.local/bin)
Releases ship amd64 only. Apple Silicon users can run the darwin_amd64 binary under Rosetta.

License

MIT

Name		Name	Last commit message	Last commit date
Latest commit History 51 Commits
.github/workflows		.github/workflows
assets		assets
bucket		bucket
docs/superpowers		docs/superpowers
internal		internal
.gitignore		.gitignore
.goreleaser.yaml		.goreleaser.yaml
LICENSE		LICENSE
README.md		README.md
config.example.toml		config.example.toml
go.mod		go.mod
go.sum		go.sum
main.go		main.go

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

cpm

Why?

How it works

Install

GitHub Releases (manual)

From source

Windows notes

Quick start

Per-project profiles (like `.nvmrc`)

Commands

Cloud sync

What gets synced

Exclude files from sync

Configuration

`~/.claude-profiles/config.toml`

Config reference

Shared file handling

Shell integration

Prompt (PS1 / Starship)

direnv

Upgrading

Platform support

License

About

Uh oh!

Releases 12

Packages

Uh oh!

Contributors

Uh oh!

Languages

Folders and files

Latest commit

History

Repository files navigation

cpm

Why?

How it works

Install

GitHub Releases (manual)

From source

Windows notes

Quick start

Per-project profiles (like .nvmrc)

Commands

Cloud sync

What gets synced

Exclude files from sync

Configuration

~/.claude-profiles/config.toml

Config reference

Shared file handling

Shell integration

Prompt (PS1 / Starship)

direnv

Upgrading

Platform support

License

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 12

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Per-project profiles (like `.nvmrc`)

`~/.claude-profiles/config.toml`

Packages