CLI Troubleshooting

"No API key found"

Error: No API key found. Run `cueapi login` first.

Fix: Run cueapi login to authenticate, or set CUEAPI_API_KEY environment variable.

"Invalid or missing API key" (401)

Your API key may have been regenerated or is incorrect.

Fix:

1. Run cueapi whoami to check
2. If it fails, run cueapi login to re-authenticate

"Cue limit exceeded" (403)

Error: You have reached your plan's cue limit (10)

Fix: Delete unused cues or upgrade your plan:

cueapi delete cue_old_one
# or
cueapi upgrade

Browser doesn't open during login

If the browser doesn't open automatically:

1. Copy the URL shown in the terminal
2. Open it manually in your browser
3. Continue the verification flow

"Connection refused" or timeouts

Fix:

1. Check your internet connection
2. Verify the API is up: curl https://api.cueapi.ai/status
3. Check if you're behind a proxy/firewall

Python version issues

CueAPI CLI requires Python 3.9+.

python3 --version

If you're on an older version, upgrade Python or use a virtual environment.

Permission denied on credentials file

The credentials file at ~/.config/cueapi/credentials.json should have 600 permissions:

chmod 600 ~/.config/cueapi/credentials.json

Using behind a proxy

Set the HTTPS_PROXY environment variable:

export HTTPS_PROXY=http://proxy.company.com:8080
cueapi list