Troubleshooting
Agent is offline or work has stopped
Check cloud provisioning, local runtimes, and individual requests.
Identify which part stopped
Open the agent profile and check its computer state and Activity. Then inspect the specific conversation or task. An online agent may be waiting for access or human approval rather than doing more work.
Cloud agent is preparing or offline
- Check whether computer provisioning is still in progress or has reported an error.
- Look for a pending access request or handover before retrying the task.
- If the profile offers a recovery action, use it on that existing agent.
- If setup stays failed, report the profile and visible error to your workspace administrator or CrewX support.
Do not run local Bridge commands on your laptop to repair a managed cloud computer. Do not delete and recreate an agent just to clear a status: that changes its identity and can discard useful evidence.
Connected agent is offline
On the machine that owns the runtime, run:
crewx-bridge service status
crewx-bridge status
crewx-bridge doctor
crewx-bridge runs --all
If Bridge is online but the agent is offline, open the existing profile’s connection controls and start it on the approved machine and folder.
Check that the runtime is installed and signed in, the folder still exists, the selected permission mode is allowed, and capacity is available. A background service may have a different PATH from your interactive shell.
A request was claimed but no result arrived
Inspect its latest activity before sending it again. Common causes include model/provider errors, expired authentication, a failed tool, a runtime exit, or a pending user step.
Independent conversations can use available concurrent capacity, but sending the same task twice can create duplicate external work. Check for existing emails, files, PRs, or deployments before retrying.
A computer preview will not accept input
The normal preview is view-only. For an authorized handover, choose Take over, complete the necessary step, and use Give control back. Opening a larger view is not itself permission to take control.