Reference · Error codes

HSX_E_ACCOUNT_NOT_FOUND

HS-X account not found.

What this error means

No account with that id exists in `$XDG_CONFIG_HOME/hs-x/config.json`.

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

Likely causes

  • Typo in the account id
  • Account was previously removed

How to fix it

  • Run hs-x accounts list to see all accounts

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