Installation

Requirements

• Python 3.10+

• Git

• PostgreSQL (local)

• VS Code or Cursor (optional — for IDE integration)

Optional: pyenv

CC integrates with pyenv to automatically activate the correct Python version when switching projects.

If pyenv is installed, CC will prompt you to link each Odoo version to a pyenv virtualenv during cc config. On every cc switch, the terminal and VS Code interpreter will be updated automatically.

If pyenv is not installed, CC works fine — Python environment switching is simply skipped.

Install

CC is installed directly from the GitHub repository:

git clone https://github.com/chronofeldyx/cc.git ~/cc
cd ~/cc
./installer.sh

The installer will:

1. Install CC as a pip package in editable mode

2. Add the cc shell function to your .bashrc / .zshrc

3. Create the ~/.cc-cli/ data directory

Restart your terminal or run:

source ~/.zshrc  # or ~/.bashrc

Verify

cc --version

First Run

Run the configuration wizard to discover your Odoo versions and set up CC:

cc config

This scans your filesystem for Odoo version directories, registers them, and walks you through all settings. You only need to do this once (or when you add a new Odoo version).

---

Next: Your First Switch