Reference · Error codes

HSX_E_DEV_WORKER_LOAD_FAILED

Worker module failed to load.

What this error means

A src/workers module threw while being imported for local invocation.

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_WORKER_LOAD_FAILED — stable to match on in scripts and agents.

Likely causes

  • Project dependencies not installed (Cannot find package)
  • A syntax or top-level runtime error in the worker module

How to fix it

  • Run bun install in the project first
  • Fix the module error shown in the message

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