Troubleshooting
Common issues and how to fix them when using CommitAI.
Git is not installed
CommitAI uses git diff to read your changes. If Git is missing, you will see:
git: command not found
Install Git:
- • macOS: brew install git
- • Ubuntu: sudo apt install git
- • Windows: Install Git from git-scm.com
No staged changes detected
If you run:
commitai commit
And see:
No staged changes found
Make sure you stage your files first:
git add .
GitHub login doesn't open
Sometimes browsers block local redirects. Try manual login:
commitai login --manual
This prints a URL you can open manually in your browser.
OAuth callback not received
CommitAI listens on:http://localhost:9900/callback
If blocked:
- • Check if another app is using port 9900
- • Disable firewall temporarily
- • Retry login:
commitai login
Token expired or invalid
If the CLI prints:
Authentication token expired
Just login again:
commitai login
Daily limit reached
CommitAI allows 30 commits per day.
When your limit is reached:
⛔ Daily limit reached (30/30) Please try again tomorrow.
The limit resets automatically at midnight.
Cannot reach CommitAI servers
Check your internet connection or try again in a few seconds.
You may also see:
Failed to reach CommitAI API
This usually resolves quickly.
Diff too large
CommitAI rejects diffs over 200 KB to avoid extremely large model requests.
Fix:
- • Stage smaller chunks using:
git add -p