sync-codebase

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).

1. 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.

1. 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.

1. 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.

1. 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.