Your First Switch

Add a Project

If CC doesn't know about your project yet, add it:

cc switch my-project

If my-project isn't in the database yet, CC will:

1. Search your filesystem for a matching directory
2. Ask you to confirm the path, version, and database
3. Ask which modules to associate with this environment
4. Save everything and switch

Switch to an Existing Project

cc switch my-project

If the project has multiple environments, you'll get an interactive selector:

Project 'my-project' has multiple environments:
Choose environment:
    my-project_v17    Branch: 17.0-feature-x    Database: my_project_v17
  ❯ my-project_v18    Branch: 18.0-feature-y    Database: my_project_v18

After selecting, CC will:

• Set the project as active
• Check out the configured branch
• Update your VS Code / Cursor settings.json (database, addons, modules, Python interpreter); launch.json debug templates are written once via cc ide setup and not touched per switch
• Open the project in your IDE
• Log the switch for timesheet tracking

Useful Flags

Navigate to the Project

After switching, cc cd will take you to the active project directory:

cc cd

Next: Core Concepts