Sync Codebase

Builds or updates the reviewer base index — vector embeddings (Postgres/pgvector) and code graph (Neo4j) — from a local repo clone using reviewer index. This is a one-time setup operation; subsequent runs are incremental (only changed files are re-embedded).

Inputs

Parse from $ARGUMENTS (all optional):

• --path <path>: path to the local repo clone. Default: current working directory.
• --ref <branch>: git ref to index. Default: main.
• --repo <owner/name>: repo identifier for multi-repo setups. If omitted, derived automatically from git remote get-url origin.
• --backend <auto|scip|treesitter>: graph backend override. Default: auto (SCIP if in PATH, else tree-sitter).

Pipeline

1. Resolve inputs. If --path not given, use the current working directory. If --ref not given, use main. If --repo not given, run:

   git -C <path> remote get-url origin
   

   Strip .git suffix, extract the last two path segments (owner/name).

2. Check prerequisites. Verify:

   • uvx is available: uvx --version succeeds.
   • The path is a git repo: git -C <path> rev-parse --git-dir succeeds.
   • The reviewer MCP server is reachable (run reviewer check or confirm the user has .env configured with PG_DSN, NEO4J_URI, VOYAGE_API_KEY).
   • Docker services are up if using the default stack: docker compose ps shows paradedb and neo4j running.
   • Stop and tell the user what is missing if any check fails.

3. Run indexing.

   uvx --from rag-reviewer reviewer index <path> --ref <ref>
   

   Add --repo <owner/name> if resolved or provided. Stream the output to the user.

   Expected duration: seconds for small repos, minutes for large ones — Voyage free tier (3 RPM / 10K TPM) causes throttling with automatic retry/backoff. That is normal, not an error. Use --limit N (if supported) for a quick smoke run.

4. Verify. After indexing completes, optionally run a diagnostic search to confirm the corpus:

   uvx --from rag-reviewer reviewer search "your query here"
   

   Or call search_code via the reviewer MCP tools directly.

5. Report. Summarise the output: chunks indexed/updated, graph nodes/edges upserted, warnings (e.g. "SCIP unavailable, fell back to tree-sitter"). If the SCIP backend was used, note that IMPLEMENTS edges and full call-graph accuracy are available; if tree-sitter, only CALLS by name are available.

Notes

• This indexes the local clone on disk — not via GitHub API. The repo must be cloned locally before running.
• For accurate graph with IMPLEMENTS edges: install scip-python first:

  npm install -g @sourcegraph/scip-python
  

  Then re-run — GRAPH_BACKEND=auto picks it up automatically.
• After reviewer index, individual PR reviews (rag-reviewer:review-pr) trigger incremental re-sync of changed files automatically via prepare_review. Full re-index is only needed when the base branch diverges significantly or after a fresh deploy.
• To sync tasks from the configured registered task board, use rag-reviewer:sync-tasks instead.