RepoContext

Commit-pinned context for coding agents.

Search the repositories that matter without guessing. Every answer carries a path, line number, and Git commit SHA.

View on GitHub Read the setup guide

No database. No embeddings. No write tools.

repocontext READ-ONLY · MCP SERVER
1
Agent question

Where is bearer authentication enforced?

2
RepoContext

Reading committed evidence at Git HEAD…

docs/architecture.md:42 990c830d58cc68d63901985e5234ed3137819802
42HTTP requests require bearer authentication.
Known fact
Directly supported by committed source.
Inference
Authentication is part of the remote trust boundary.
Gap
Production endpoint ownership is not registered.

Evidence set 8e44b735…be61

How it works in three steps

Git stays the source of truth.

RepoContext reads committed evidence at HEAD, applies repository exposure policy, and returns bounded citations your agent can verify.

1 Register repositories

repositories:
  - name: storefront
    path: ../storefront
    branches: [main]
  - name: api
    path: ../api
    branches: [main]
Git HEAD Exposure policy

2 Ask through MCP

Which service owns checkout?

3 Verify every answer

docs/architecture.md:42 990c830d58cc68d63901985e5234ed3137819802

A deliberately narrow trust boundary.

Read the architecture
Read-only tools
RepoContext never writes, commits, or changes repository state.
Sensitive paths blocked
Environment files, credentials, keys, tokens, and secrets fail closed.
Dirty work excluded
Local answers come from committed HEAD, with stale documentation signaled.
Documentation-only HTTP
Remote images contain a generated docs and manifest snapshot, not source code.

From install to cited answer.

Install the public package, configure a registry of Git roots, then connect the stdio server to your MCP client.

npx -y @shmindmaster/repocontext@latest help
# Follow the setup guide to create a registry and MCP client configuration.

Works with Claude Code, Codex, Cursor, Windsurf, Zed, and Continue.

Eight read-only MCP tools

  • wiki.catalog
  • wiki.search
  • wiki.get
  • wiki.analyze
  • repo.inspect
  • repo.read
  • repo.search
  • repo.compare

MIT licensed. Built in public.
Contributions backed by repeatable validation.

View on GitHub → Contributing guide →