Skip to content
Kitsy Docs Open COOP

Configuration

Configuration

COOP separates workspace config from project config:

  • .coop/config.yml stores workspace-level selection such as current_project
  • .coop/projects/<project.id>/config.yml stores project-specific behavior

Typical project config areas:

  • project: name, id, aliases
  • id_prefixes and id.naming
  • defaults
  • scheduling
  • ai
  • plugins
  • github
  • api
  • hooks
  • index

Useful commands:

Terminal window
coop project show
coop config project.name "Payments Platform"
coop config project.id payments-platform
coop config project.aliases pay,ledger.master
coop config artifacts.dir docs/agent-artifacts
coop config ai.provider codex_cli
coop config ai.model gpt-5-mini
coop config workflow.task-transitions.in_review done,todo,blocked,canceled

For naming-specific configuration, see Naming and Aliases and Naming.