Troubleshooting¶
Start every diagnosis with:
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:
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.