HSX_E_DEV_MANAGED_START
Managed dev session failed to start.
What this error means
The detached hs-x dev process did not reach the ready state.
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_START — stable to match on in scripts and agents.
Likely causes
- Project validation failed
- A required port is occupied
- The child process exited
How to fix it
- Read the stderrPath returned in the error payload
- Resolve the startup error and run
hs-x dev startagain
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.
Keep going