HSX_E_DEV_BAD_ONLY
Invalid --only selector.
What this error means
An `--only` selector passed to `hs-x dev` did not parse. Selectors scope the dev output stream to specific lanes, levels, or capabilities.
When this error stops a command, hs-x exits with code 2. With --json, the failure is reported as a structured error whose code field is HSX_E_DEV_BAD_ONLY — stable to match on in scripts and agents.
Likely causes
- An empty selector (
--only ""or--only cap:) - A typo in a lane or level name
How to fix it
- Use a lane:
--only frontend,--only backend,--only request,--only hubspot - Use a level:
--only errors,--only warnings - Match a capability or message:
--only cap:<id>or--only <text> - Repeat --only to combine selectors
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