Troubleshooting
Fix the common setup problems quickly.
Most failures are auth, missing CLI path, no diff, duplicate review topic, or a precommit finding doing its job.
Fast diagnostics
Terminal
> almightygpt auth status> almightygpt runs latest> git statusCommon fixes
CLI not found
Run npm install -g almightygpt, then restart the terminal or set the VS Code almightygpt.cliPath setting.
Auth shows missing
Run almightygpt auth status. If VS Code is the only place you set keys, use @almightygpt /auth inside VS Code Chat.
Keychain error
Use an environment variable as a temporary override, then fix the OS keychain permission issue.
Review file already exists
Use a new --topic slug or pass --force when you intentionally want to overwrite.
Precommit blocks
Read the precommit artifact, fix the finding or shallow review warning, then rerun almightygpt precommit --strict.
No diff to review
Make a file change first, or pass a git range such as HEAD~1..HEAD.