Skip to content

Troubleshooting

Start every diagnosis with:

codoo --version
codoo doctor
codoo env show
codoo core show

Common diagnostic codes

Code Meaning Action
CODOO-PROJECT-001 codoo.json is missing Run from the project root or pass --path
CODOO-PROJECT-002 addons/ is missing Restore the directory or initialize a clean project
CODOO-PROJECT-003 Invalid project JSON Correct the reported JSON syntax
CODOO-VENV-001 Virtual-environment Python is missing Run codoo env setup --target venv --yes
CODOO-RUN-001 External executable is unavailable Install it and ensure it is on PATH
CODOO-RUN-002 External command failed Re-run with --verbose and inspect its output
CODOO-LINT-XML-001 XML validation failed Correct the reported file and line
CODOO-LINT-JS-001 JavaScript validation failed Correct the reported JavaScript issue

codoo is not found

Confirm the pipx binary directory is available:

pipx ensurepath

Restart the shell, then verify with codoo --version.

Docker is unavailable

Install Docker Engine/Desktop and its Compose plugin, verify docker compose version, then run codoo doctor again. Use codoo env use venv when Docker is not required.