Reference · Error codes

HSX_E_INTERNAL

Internal error.

What this error means

HS-X hit an unexpected internal failure — a bug or an unhandled edge case rather than something you did wrong.

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

Likely causes

  • A bug in the CLI
  • An unexpected failure in an underlying operation (filesystem, parsing, or a wrapped error)

How to fix it

  • Re-run with --json and include the output in a bug report
  • Check you are on the latest hs-x version

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