Reference · Error codes

HSX_E_INIT_DIR_NOT_EMPTY

Project directory already exists.

What this error means

`hs-x init` refused to overwrite an existing project.

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

Likely causes

  • You ran init in a directory that already has an hsx.config.ts

How to fix it

  • Pick a different name or directory
  • Delete the existing one
  • Pass --force to overwrite

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