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 launch.json

• Open the project in your IDE

• Log the switch for timesheet tracking

Useful Flags

Flag	Description
cc switch my-project -s	Switch without opening the IDE
cc switch my-project -n	Open in a new IDE window
cc switch my-project -i	Ignore saved config and re-discover

Navigate to the Project

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

cc cd

---

Next: Core Concepts