skip to content
ccdocs
Commandscc project

cc project env

Manage the environments of a project. The first positional is an action; the second is a target (a project for list/create, an environment name for delete/edit/archive/…).

Usage

cc project env [action] [target] [flags]

Actions

ActionDescription
list (default)List environments for the active project (or [target] project)
createCreate an environment (no project given → project picker)
deleteDelete an environment (by name; collision → project picker)
editEdit an existing environment
archiveSet the environment's status to archived
activateSet the environment's status to active
mergedSet the environment's status to merged
pinPin an environment so it always shows in the picker
unpinUnpin an environment

The old add/remove verbs still work as silent aliases for create/delete.

Flags

FlagDescription
-y, --yesSkip confirmation prompt
--jsonOutput as JSON (list action only)
--fw, --portsWith create: scan the fork and add the ticket's forward-port environments

Environment names aren't unique across projects. delete/edit/archive/pin resolve by environment name; if the same name exists in more than one project, cc pops a project/env picker instead of guessing. With no target, it acts on the active project's environments.

Examples

cc project env                      # list environments for the active project
cc project env list acme            # list environments for 'acme'
cc project env list --json          # machine-readable listing
cc project env create               # pick a project, then name the new environment
cc project env create acme          # create an environment in 'acme'
cc project env create acme --fw     # add the ticket's forward-port envs
cc project env delete staging       # delete the env named 'staging' (picker if ambiguous)
cc project env edit                 # interactive picker to edit an environment
cc project env archive old_feature  # mark an environment archived
cc project env pin staging          # keep 'staging' in the picker regardless of recency

Edit options

When editing an environment, you can update:

  • Name — rename the environment
  • Branch, Version, Project path, GitHub URL
  • Database — change the linked PostgreSQL database
  • Modules — update the module list (used for -u in launch config)
  • Tickets — the Odoo task IDs cc ticket opens (comma-separated)
  • Notes, Status (active / merged / archived), SSH Tunnel

On this page