Troubleshooting

Use this when something is not working.

Install

I cannot find a Windows installer

Windows builds are coming soon. Use macOS Apple Silicon or Linux x64 for now.

The app will not open

Check:

1. You downloaded the right platform build.
2. Your OS allows the app to run.
3. You have enough disk space.
4. You restarted the app after install.

Models

No model is available

Check:

1. A provider is connected.
2. The API key is valid.
3. The provider account has access to the selected model.
4. Your network can reach the provider.

Responses are slow

Try:

1. Start a new session.
2. Use a smaller prompt.
3. Choose a faster model.
4. Check provider status.

Agents

The answer feels too broad

Ask for a smaller next step:

Do only the first safe step and show evidence.

The agent wants to edit too much

Stop and narrow the task:

Touch only the files needed for this issue. If more work is needed, explain it first.

The agent made an unsupported claim

Ask:

Which docs, files, tests, or tool output support that?

Integrations

Slack, Datadog, or GitLab is missing

Those integrations are planned. Available integrations are GitHub, Linear, Jira, Sentry, and Telegram.

Sentry is not working

Check:

• SENTRY_AUTH_TOKEN
• SENTRY_ORG

Workflows

A workflow will not move forward

A gate is probably missing evidence.

Ask k9:

What gate is blocking this workflow, and what evidence is missing?

Common blockers:

• Missing approved PRD or ADR.
• Missing stories.
• Acceptance criteria are not measurable.
• Tests have not been run.
• Review is not complete.

Secrets

I pasted a secret into chat

Rotate the secret. Then remove it from any shared logs, docs, tickets, or transcripts where possible.

Report a problem

Include:

• Platform.
• App version or channel.
• Model provider.
• Agent used.
• Integration involved, if any.
• Error message.
• What you expected.
• What happened.