D/ DELEGATOR DOCSOpen workspace ↗
09 · Help / USER GUIDE

Find the missing boundary.

Check the specific failed stage before repeating an action. Most indicators describe evidence, not the whole system.

What you seeWhat to check next
Preview opens disconnectedExpected before an owner profile is provided. Run that exact installation’s doctor; verify you are using the preview or central profile you intended.
Workspace asks for sign-in againSign in normally. Logout, expiry or service restart can invalidate the browser session. Device enrollment and provider sign-in are separate.
Device online, no visible agent progressRead the session’s supported runtime evidence and saved next action. A fresh receipt only proves reporting.
A session is missingCheck allowed roots, provider version, source filters and partial coverage. Do not widen roots or import history automatically.
Project or worktree looks wrongReview repository evidence and correct the owner project label. Do not assume native and Desktop project IDs are interchangeable.
Collector says owned elsewhereUse the existing watcher’s window or terminal. Stop it through its own controls before starting another.
History says partial or pendingInspect that session’s coverage and capture limits. Do not move/delete its spool or checkpoint during pending capture; ask the owner for exact recovery.
Answer is saved but session did not continueCheck submitted/native-ack/completed receipts and bridge identity. An observer-only session has no general answer channel.
Save failed or timed outRefresh and reconcile current state. Review a revision conflict before resaving; check for an existing create before retrying.
CEO note exists, no fix followedRead the assigned next actor. A read/report grant permits a recommendation; it does not provide code execution or delegation.
Native chat exists but Desktop cannot open itSeparate native creation, correct destination/project placement and Desktop visibility/Open evidence. Escalate the exact stage.
SSH/profile connection failsUse normal native SSH sign-in and verified host trust. The original preview refuses direct fallback when configured for its managed SSH route.

Safe diagnostics

delegator --help
delegator doctor
delegator app status

Use the exact executable and profile for the installation you are diagnosing. app status reports the managed preview app; it is not a universal central collector status command. Central watch status comes from its owning UI/helper and the accepted server receipt.

Report a useful issue

Include the action, expected result, local time and timezone, build/version, whether the problem is repeatable, and the last successful stage. Add sanitized diagnostics and the affected task. Keep account tokens, provider sign-in files, raw transcripts and private config contents out of screenshots and public issues.

Current gaps

For exact availability, use the release and status page.