21. Troubleshooting — fixes by symptom and FAQ
This chapter has moved to one page per kind of symptom.
| What is wrong | Page |
|---|---|
| The power button’s badges, a start that stopped, the disk, installing an agent’s CLI | Fix a workspace that will not start or has stopped |
| Sessions that are missing or will not resume, cut-off turns, sharing, cleanup, scheduled runs, notifications | Find a missing session or one that will not resume |
| An agent’s expired login, the models offered, the assistant | Fix an agent’s login or a missing model |
| Cloning, submodules, authentication on a private repository | Fix a failed clone or Git authentication |
| The browser pane, the lightweight preview, preview subdomains | Fix a preview or browser pane that does not show |
| MCP servers, cloud-account commands, Jira, apps that connect from outside | Fix MCP, cloud and Jira integrations |
| Keys, copy and paste, the theme, the phone layout, menus | Fix the terminal, keys and phone layout |
| What to try first, and the FAQ | Read the frequently asked questions |
| Reporting a bug in Agent Fleet itself, or requesting a feature | Report a bug or request a feature |