Skip to content

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