cc-profiles Documentation PyPI GitHub Install

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
cc-profiles in use: a project moved between profiles, then its memories, a conversation, skills, an MCP server, a comparison and the backup

Source code, issues and releases are on GitHub; the package is on PyPI.

Using cc-profiles

  1. Why cc-profiles: what it adds to CLAUDE_CONFIG_DIR and shell aliases
  2. Getting started: install, first run, launcher commands, keyboard shortcuts; on macOS, the Mac app
  3. Concepts: profiles, the source profile, projects, rules, sharing, backups
  4. FAQ: several accounts, a profile per project, credentials, safety, undo
  5. How-to, step by step:
  6. 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: claude starts 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 /config settings, 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
  7. Configuration reference: config.json, command line, environment variables
  8. Troubleshooting
  9. Glossary, Privacy, Uninstall, What’s new

Working on cc-profiles