Troubleshooting

An agent shows as “not installed”

Open Settings → Providers. Each card checks one thing: is that CLI on your system? If it’s missing, the card shows the exact install command.

1. Run the install command in a terminal (a regular one or an ADE shell pane both work).
2. Fully quit Kadro ADE and relaunch. The app needs a fresh start to see a CLI that was installed while it was running.
3. Back in Settings → Providers, the card should now show the CLI as installed. The refresh button re-checks without relaunching.

Remember that each agent signs in inside its own pane — an installed CLI that asks you to log in on first launch is working as intended.

Sign-in finishes in the browser, but the app stays locked

After you complete sign-in in the browser, the app picks it up automatically within a few seconds. If the app stays on the sign-in screen:

1. Keep the app running and give it a moment — then check whether your browser is showing an Open Kadro permission prompt it wants you to confirm.
2. If you have an older copy of Kadro ADE on disk, delete it — two installed copies can confuse the hand-back.
3. Click Sign in with Browser again to restart the flow fresh.

If the screen shows a red sign-in error, the message is the actual reason — quote it when you contact support.

Signed in, but “no active subscription”

The subscription screen offers everything you need:

• Open pricing — subscribe to Pro on the pricing page.
• Account billing — fix or restart an existing subscription on your account page.
• Sync access — click this after finishing in the browser; it re-checks your plan and lets you in.
• Sign out — if you signed in with the wrong account.

The update pill never appears

Kadro ADE checks for updates on launch and about once an hour while running. If a release just went out, give it a few minutes — or quit and relaunch, which forces a check. Updates download from GitHub, so a network that blocks GitHub will quietly prevent them; in that case, grab the latest from the download page directly.

Crash diagnostics

Diagnostics are off by default — until you opt in, nothing leaves your machine. Toggle them in Settings → Privacy. Reports are anonymized, kept for 30 days in an EU data region, and turning the switch off stops new reports immediately.

Reporting a bug

Email support@kadrotools.ai with what you were doing, what you expected, what happened (exact error wording helps), and your Kadro ADE version from Settings → Account. Or skip email and post in the Discord — it’s usually faster.