cc-profiles documentation
cc-profiles is a local web UI to manage several Claude Code profiles on one machine: move projects, memories and conversations between them, share skills and plugins, edit every setting of /config, build the status line, see the tokens you use, and undo any change from a backup.
curl -fsSL https://raw.githubusercontent.com/andreaiannarone/cc-profiles/main/install.sh | sh
cc-profiles open
Source code, issues and releases are on GitHub; the package is on PyPI.
Using cc-profiles
- Why cc-profiles: what it adds to
CLAUDE_CONFIG_DIRand shell aliases - Getting started: install, first run, launcher commands, keyboard shortcuts; on macOS, the Mac app
- Concepts: profiles, the source profile, projects, rules, sharing, backups
- FAQ: several accounts, a profile per project, credentials, safety, undo
- How-to, step by step:
- Guides by tab:
- Projects: move, relink, assign
- Memories: browse, edit, move
- Conversations: read, move one to another profile, delete
- Usage: tokens and estimated cost per day, project, model and profile
- Profiles and sharing: create, edit, delete, share
- Profile by folder:
claudestarts in the profile of the folder you are in - Skills and MCP servers: browse, create, edit, copy and delete skills and MCP servers
- Agents: create, edit, copy and delete subagents, with a form for their model, tools and instructions
- Commands: create, edit, copy and delete custom slash commands
- Search and compare: search every profile at once, compare two profiles side by side
- Plugins: see the installed plugins and turn them on or off
- Export and import: move a profile to another computer
- Settings: the
/configsettings, hooks, keyboard shortcuts,CLAUDE.md, permissions, raw JSON - Status line: build the line under Claude Code’s prompt, or write your own
- Backups: what gets saved and how restoring works
- Health and About: checks, orphan projects, disk space, installing Claude Code
- Configuration reference:
config.json, command line, environment variables - Troubleshooting
- Glossary, Privacy, Uninstall, What’s new
Working on cc-profiles
- Architecture: how the code is organized and why
- Claude Code’s on-disk formats: what the app reads and writes
- HTTP API: every endpoint the UI uses
- Contributing and design system
Something wrong, unclear or missing on this page? Open an issue on GitHub