- Read
README.mdfor setup and command usage. - Check
docs/operations/troubleshooting.mdfor known failure modes. - Reproduce with fresh state where possible (
.datareset, clean terminal logs).
Use GitHub Issues:
Include:
- platform and versions (
node,pnpm,codex --version) - exact reproduction steps
- expected vs actual behavior
- relevant logs (
.data/logs/codex.log, API output)
Use GitHub Issues and describe:
- problem statement
- desired behavior
- why current behavior is insufficient
Use GitHub Discussions if enabled:
- Browse:
Discussions - Create:
New discussion
If Discussions are not enabled, use GitHub Issues with a clear question title.
Do not publish sensitive vulnerability details in a public issue.
If private reporting is available in your repository settings, use that channel. Otherwise open a minimal issue requesting a private reporting path from maintainers.