Common Issues

Authentication Issues

Can't sign in with email and password

Symptoms: Login fails with "Invalid credentials" error.

Solutions:

1. Verify your email address is correct (check for typos)
2. Reset your password using the "Forgot password" link
3. Check if your account requires email verification — look for a verification email in your inbox (and spam folder)
4. If you originally signed up with Google or GitHub, use that method instead

OAuth sign-in stuck or failing

Symptoms: Google or GitHub sign-in redirects back without logging you in.

Solutions:

1. Clear your browser cookies for both the platform and the OAuth provider
2. Try signing in with an incognito/private browsing window
3. Disable browser extensions that might block OAuth redirects (ad blockers, privacy extensions)
4. Ensure pop-ups are allowed for the platform domain

Magic link not arriving

Symptoms: Requested a magic link but never received the email.

Solutions:

1. Check your spam/junk folder
2. Verify you're checking the correct email address
3. Wait 2-3 minutes — email delivery can be delayed
4. Request a new magic link (previous ones expire after 10 minutes)
5. Try signing in with email/password instead

AI Feature Issues

AI responses are slow or timing out

Symptoms: Long wait times or timeout errors when using GenAI Studio or agents.

Solutions:

1. Try a faster model — Switch to Gemini Flash or Claude Haiku for quicker responses
2. Reduce context — Long conversations increase processing time; start a new chat
3. Check provider status — Visit the AI provider's status page (status.anthropic.com, status.openai.com)
4. Simplify your prompt — Break complex requests into smaller, focused prompts

"API key invalid" error

Symptoms: AI features return an API key error.

Solutions:

1. Go to Settings > Integrations and verify your API key
2. Ensure the API key has the required permissions
3. Check if the API key has expired or been revoked
4. Generate a new API key from the provider's dashboard
5. Ensure there are no extra spaces in the key

Image generation failing

Symptoms: Image generation returns errors or blank results.

Solutions:

1. Check your prompt — Avoid prohibited content that may be filtered
2. Try a different model — Switch between Imagen, GPT Image, or FLUX
3. Reduce complexity — Simpler prompts are more reliable
4. Check usage limits — You may have reached your plan's monthly limit

Desktop App Issues

Desktop app won't start

Symptoms: App crashes on launch or shows a blank screen.

Solutions:

1. Restart your computer — Clears hung processes
2. Check system requirements — macOS 12+, Linux with glibc 2.31+, Windows 10+
3. Reinstall the app — Download the latest version
4. Check logs — Look for error output in the system console

Agent stuck or not responding

Symptoms: The agent seems frozen and doesn't produce output.

Solutions:

1. Check the API server — The sidecar process should be running (check Activity Monitor / Task Manager)
2. Verify API keys — Go to Settings and confirm your provider API keys are valid
3. Check network — AI features require an internet connection
4. Cancel and retry — Cancel the current task and start a new one
5. Restart the app — Close and reopen the desktop app

MCP server connection failed

Symptoms: An MCP server shows as disconnected or tools are unavailable.

Solutions:

1. Check the server command — Ensure the command path is correct and the binary exists
2. Verify dependencies — Some servers require Node.js, Python, or other runtimes
3. Check environment variables — Required env vars must be set in the MCP config
4. View server logs — Check Settings > MCP for error details
5. Restart the server — Disable and re-enable the MCP server in settings

Memory not recalling information

Symptoms: The agent doesn't remember things you told it in previous sessions.

Solutions:

1. Check memory is enabled — Verify in Settings > Memory
2. Check embedding provider — The local embedding model must be loaded, or a cloud provider configured
3. Verify storage — Ensure adequate disk space for the vector database
4. Manually store — Use "Remember that..." to explicitly store important information

Integration Issues

Linear integration not connecting

Symptoms: Linear API calls fail or the pipeline won't start.

Solutions:

1. Verify your Linear API key is valid and not expired
2. Ensure the API key has access to the target team and project
3. Check webhook URL if using webhook trigger mode
4. Test the connection using the "Test" button in Settings > Connectors

Google Workspace tools unavailable

Symptoms: Google tools don't appear or return permission errors.

Solutions:

1. Re-authorize — Your Google OAuth token may have expired; reconnect in Settings
2. Check scopes — Ensure you granted access to the specific Google service
3. Admin restrictions — Your Google Workspace admin may restrict third-party app access
4. Rate limits — Google APIs have rate limits; wait and retry

Jira triage not analyzing tickets

Symptoms: The Jira Triage Agent can't access or analyze tickets.

Solutions:

1. Verify your Atlassian API token and site URL
2. Ensure your Atlassian account has access to the target project
3. Check that the API token hasn't expired
4. Test with a single ticket before running bulk triage

Billing Issues

Payment method declined

Symptoms: Subscription upgrade or renewal fails.

Solutions:

1. Verify your card details are current
2. Check with your bank for any blocks on online payments
3. Try a different payment method
4. Contact support if the issue persists

Can't access paid features after upgrade

Symptoms: You upgraded but still see free plan limitations.

Solutions:

1. Sign out and back in — Your session may have cached the old plan
2. Check the correct account — Ensure you upgraded the right account (personal vs. team)
3. Wait a moment — Plan changes may take up to 30 seconds to propagate
4. Contact support — If the issue persists after 5 minutes