Troubleshooting
Match the symptom to its fix, and know where to go when a fix doesn't work.
My session won't connect
Click Reconnect. The terminal also retries on its own, with a countdown ("Reconnecting in Ns"), and keeps retrying until it gets through.
Your conversation isn't lost. The session keeps running while you're disconnected, and if you reconnect within about 10 minutes the whole conversation is still on screen. A tab hidden for more than 30 minutes pauses the connection; return to the tab to pick the session back up. If reconnecting keeps failing, reload the page.
My screen says "Workspace blocked"
Billing is pausing new activity, and the screen states why. Click Open billing to fix it (or ask an admin to). After a billing fix, unblocking can take up to a minute, so click Retry once the change is made. Billing explains each reason and its fix.
A preview looks wrong or missing
| Symptom | Fix |
|---|---|
| "Preparing your preview" won't clear | A file the terminal just created can take up to a minute to appear the first time. It clears on its own. |
| The preview looks stale | Press ⌥R to refresh. Previews normally refresh themselves whenever the terminal finishes a piece of work. |
| A card appears instead of a preview | The file is too large, corrupt, or of an unsupported type. The card explains which. The file still works in the terminal: reference it with @. |
Voice input says "Microphone blocked"
Allow microphone access for this site in your browser's site settings, then hold ⌥Space and try again. The permission lives in your browser, not in Cap Orbit.
I see an update notice
| Notice | Fix |
|---|---|
| Amber "Update available" pill in the header | Reload the page. |
| "New terminal version available" or "Updated commands available" inside a session | Open a new session; existing sessions keep running on the old version. |
Still stuck?
Ask inside any session: type /help followed by your question and the answer comes back on the side, without interrupting the work. For billing and seat problems, an admin in your organization can act where you can't. For anything these steps don't cover, reach out to your customer success contact.