Troubleshooting

The errors a new user hits first, and how to clear each one. When a command fails, the CLI points you here.

“No 0dai config found”

Your project has no ai/ layer yet. Run 0dai init to scaffold it, or 0dai init --local to do it offline with no account.

“Not authenticated”

Your CLI session expired or was never set up. Run 0dai auth login: it opens a device-code link — sign in with GitHub or Google, no API key to paste. Check the current session with 0dai auth status.

“Daily swarm limit reached”

The free tier includes one swarm task per day so you can try the run → PR flow. After that, wait for the midnight-UTC reset or move to Pro (50 tasks/day) at 0dai.dev/pricing.

“SECRET DETECTED — commit blocked”

The secret scanner matched something that looks like a credential. If it is a real secret, remove it. If it is a false positive, add a file: / line: / reason: entry to ai/secret_scanner_allowlist.yaml and re-run.

Still stuck?

Run 0dai doctor for a health check with the next command to try, or open an issue at github.com/0dai-dev/0dai.