Skip to content

index_repository by project name fails with 'repo_path is required' but reports 'crashed on a file' #1211

Description

@asemraza

Version: 0.9.0, macOS (Darwin 25.5, arm64)

Repro:

  1. Have an already-indexed project (indexed originally by path).
  2. Call the MCP tool index_repository with only the project name: {"project": "<name>"} (or equivalently cli index_repository '{"project": "<name>"}').
  3. Result: {"status":"error","outcome":"exit_nonzero","hint":"Indexing worker crashed on a file..."}

Actual cause (from the worker log referenced by index.supervisor.worker_failed):

repo_path is required
level=info msg=index.worker.fast_exit action=_Exit

The worker exits because it never receives repo_path when the call is made by project name - no file crash is involved.

Two issues:

  1. Re-indexing an existing project by name does not resolve the stored repo path before spawning the worker (list_projects clearly knows the root_path, so resolution data exists).
  2. The supervisor's generic hint ("crashed on a file... a future release isolates the culprit file") is misleading for this failure class - surfacing the worker's actual stderr line would have saved the debugging detour.

Workaround: call with the explicit path: cli index_repository --repo-path /path/to/repo - works perfectly (and the built-in exclusion list in 0.9.0 is excellent, thanks for .claude/.codex).

Great tool otherwise - we run it across a multi-repo Laravel/TS setup shared between Claude Code and Codex.

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't workingeditor/integrationEditor compatibility and CLI integrationpriority/normalStandard review queue; useful PR with ordinary maintainer urgency.stability/performanceServer crashes, OOM, hangs, high CPU/memoryux/behaviorDisplay bugs, docs, adoption UX

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions