Multi-Version Mode

The Problem

Odoo developers often maintain projects across multiple versions simultaneously — a v17 client, a v18 client, and a v19 project all running at the same time.

In standard mode, CC tracks one active project globally. Switching to a v19 project would overwrite your v17 active state, even if you have both running in separate terminals.

Multi-Version Mode

When enabled, CC tracks one active environment per Odoo version instead of one globally.

Version	Active Project
v17	globex
v18	initech
v19	acme

Switching to a v19 project only updates the v19 slot — your v17 and v18 active projects are untouched.

Enable It

cc config

Select Multi-version mode and set it to true.

How Active Resolution Works

When CC needs to know your active project (e.g. for cc switch with no args, cc module, cc time), it detects which Odoo version your current working directory belongs to and looks up the active environment for that version.

If you're in a v19 directory → active project is the v19 slot. If you're in a v17 directory → active project is the v17 slot.

When to Use It

Enable multi-version mode if you regularly have multiple terminals open across different Odoo versions at the same time. If you only work on one version at a time, single mode is simpler.