idx

Common Errors

Command dispatch and argument contract

• missing command: got ... expected one of [sync init status inspect watch destroy search]
• unsupported command "...": expected one of [sync init status inspect watch destroy search]
  • Note: daemon, version, and help/version flags are also accepted by command dispatch.
• inspect accepts at most one path: got ... expected idx inspect [path]
• invalid inspect path "...": expected idx inspect [path]
• expected project path argument (daemon enable/disable)

Search flag validation

• missing search query: got ... expected idx search <terms>
• unsupported --format value "...": expected one of [text json]
• --json-pretty requires --format json: got format "..."
• invalid --context value ...: expected a non-negative integer
• invalid --from value ...: expected a non-negative integer
• invalid --size value ...: expected a positive integer
• unsupported --operator value "...": expected one of [AND OR]
• invalid --relaxation value "...": expected format >N where N is a non-negative integer
• invalid --relaxation with --operator "...": expected "AND"

Index lifecycle and state errors

• sync must run from project root: got current directory "...", expected root directory "..."
• sync requires project root to be indexed: no index found at "...", run idx init first
• destroy must run from project root: got current directory "...", expected root directory "..."
• no index found at "...": run idx init first (inspect with path)
• no index found under project root "...": run idx init first (inspect without path or status)

Status-specific validation

• no index found under project root "...": run idx init first
• unindexed directories found: [...] — run idx sync to update
• stale index at "...": run idx sync to update

Watch and daemon errors

• invalid --debounce value ...: expected a duration greater than 0
• failed to run watch command: got invalid debounce ..., expected duration greater than 0
• cannot run watch: daemon is already monitoring this project. Disable the daemon with 'idx daemon disable' first
• project "..." not being monitored
• project "..." not being monitored: no projects active
• failed to start watch for "...": got error ..., expected process to start

Recovery Quick Guide

1. Run idx init to bootstrap indexes.
2. Run root-scoped commands (sync, destroy) from the project root.
3. Validate flags and positional arguments.
4. Use idx daemon status before starting idx watch.
5. Use idx status to verify whether index logs still match file modification timestamps.

This site is open source. Improve this page.