Troubleshooting
Most issues come down to auth or account state. Here's where to start.
| Symptom | Fix |
|---|---|
| "Not logged in" | Run ai login. |
| Auth or permission errors | Run ai whoami to confirm the signed-in account. |
| Usage or quota errors | Run ai --usage to check your remaining usage and reset time. |
| Stuck on the wrong account | Run ai logout, then ai login again. |
Anything else
Re-run the command and report the printed error message. There is no client-side debug mode by design — the printed error is the source of truth for what went wrong.
When in doubt,
ai whoami followed by ai --usage answers most "why isn't this
working" questions in two commands.