claude-profiles 0.2.0

Manage multiple Claude Code profiles — credentials, skills, and memories across nodes

claude-profiles

Manage multiple Claude Code profiles across machines. Share skills, memories, plugins, and settings while keeping credentials separate per profile.

Install

uvx claude-profiles          # run directly
uv tool install claude-profiles  # or install as a tool

Quick start

# Create a new profile
claude-profiles create r                       # -> ~/.rclaude
claude-profiles create work --copy-creds-from s  # with credentials

# Or discover existing ~/.{x}claude directories
claude-profiles init

# Check everything looks right
claude-profiles status

Profile names

The claude suffix is implicit — profile names are just the prefix:

Directory	Profile	Alias
~/.claude	default (canonical)	claude
~/.sclaude	s	sclaude
~/.rclaude	r	rclaude

Launching profiles

# One-off
claude-profiles run s
claude-profiles run r --model opus

# Or add aliases to your shell rc:
eval "$(claude-profiles shell-init)"
# Now just type:
sclaude
rclaude -p 'explain this'

What's shared vs separate

Shared (symlinked to ~/.claude)	Per-profile
skills/ — custom slash commands	.credentials.json — auth tokens
projects/ — project memories	.claude.json — account identity
plugins/ — installed plugins	history.jsonl — session history
plans/ — saved plans	sessions/, cache/, debug/
settings.json — preferences

Credential sync

Push credentials between local profiles, SSH hosts, and Docker containers.

claude-profiles sync -f local:s -t remote:gpu-box -v
claude-profiles sync -f local:default -t docker:abc123
claude-profiles sync -f remote:serverA -t remote:serverB
claude-profiles sync -f local:s -t remote:node:r

Location syntax

local[:profile]              Local profile (default src: s, dst: default)
remote:host[:profile]        SSH host (default: ~/.claude)
docker:container[:path]      Docker container (default: /root/.claude)

Commands

Command	Description
create <name> [--copy-creds-from]	Create a new profile with symlinks
init	Discover existing profiles, set up symlinks
status	Show profiles, link health, credential status
run <profile> [args...]	Launch claude with a profile
shell-init	Print shell aliases for .zshrc/.bashrc
link	Re-create symlinks if broken
sync -f SRC -t DST [-v]	Sync credentials between locations