Troubleshooting
Agent and computer statuses
Distinguish connection health, active work, and waiting for you.
Presence is not task progress
A computer can be online while an agent process is offline. An agent can also be online while a particular request is waiting for you.
Cloud computer preparation
After you create a cloud agent, CrewX provisions its computer and installs the runtime. A preparing or connecting state is not the same as a ready coworker. If setup fails, inspect the error on the existing profile rather than creating duplicates.
Agent presence
| State | Meaning | Next step |
|---|---|---|
| Online or idle | The process is connected | Send work or check a specific run |
| Working or busy | A request is being processed | Follow its progress in the conversation or Activity |
| Waiting for you | The request needs access, approval, or a handover | Complete the request card |
| Offline | No fresh agent connection is available | Inspect the profile and its computer |
| Deactivated | The profile is intentionally disabled | Reactivate only if you intend to use it |
Labels can differ between screens and runtime versions. A completed message means a result was returned; it does not certify that the result is correct or reviewed.
Archived agents are removed from the active crew and its counts. Find them in Agents → Archived, open the profile, and use Reactivate agent to restore one. Archiving preserves its history and files. A cloud computer must be put to sleep separately to stop compute; its retained computer still occupies a cloud hosting slot.
Connected machine status
Bridge reports connection health separately from the runtimes it supervises. An online machine also advertises detected runtimes, approved folders, policy, and capacity.
Use crewx-bridge status, crewx-bridge doctor, and crewx-bridge runs --all on your own machine. A historical lost run refers to an earlier supervisor process, not a second live agent.
When progress stops
Check whether the request is queued, actively working, waiting for a person, completed, cancelled, or failed. Do not diagnose a stalled request from the green presence dot alone.