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. |
| Signed in with the wrong credentials | Run ai logout, then ai login with your intended account. |
| Local session was used with a different sign-in | The session and its history are still yours and remain on this computer. To continue it, sign in with the TheGitAI account you used for that session or start a new session. Contact support@thegit.ai for an accidental duplicate account. |
stdin or stdout is not a terminal | Run coding sessions directly in an interactive terminal; piped one-shot coding is not supported. |
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.