HSX_E_DEV_MANAGED_SESSION

Managed dev session unavailable.

What this error means

The requested agent-managed dev session is missing, invalid, or no longer healthy.

When this error stops a command, hs-x exits with code 1. With --json, the failure is reported as a structured error whose code field is HSX_E_DEV_MANAGED_SESSION — stable to match on in scripts and agents.

Likely causes

  • The session id is stale or mistyped
  • The managed process exited unexpectedly

How to fix it

  • Use the exact session id returned by hs-x dev start
  • Inspect it with hs-x dev status --session <id> --json

Still stuck? Re-run the command with --debug for the wire-level detail, or hs-x doctor to check accounts, link state, and connectivity in one pass.