index

Index (or re-index) the current project into the OpenTrace knowledge graph. Use when: "index this repo", "re-index", "update the graph", "build the index"

Index the current project into the OpenTrace knowledge graph so that agents and skills can query it.

Arguments

$ARGUMENTS

Instructions

  1. Determine the target path: If the user provided a path in the arguments, use that. Otherwise default to the repository root (find it with git rev-parse --show-toplevel).

  2. Run the indexer: Change directory to the target path and run the indexer. This ensures the .opentrace/ directory is created in the right place.

    cd <path> && uvx opentraceai index .

    Use --verbose if the user asked for verbose/debug output. Pass through any other flags the user specified (e.g. --db, --repo-id, --batch-size).

  3. Report results: After the command completes, summarize what was indexed. If the command fails, show the error and suggest fixes (e.g. missing uv or dependencies, wrong path).

  4. Verify: Run uvx opentraceai stats (passing the same --db flag if the user provided one) to show the updated graph contents so the user can confirm the index looks right.