Skip to content

repoctx

Local repo intelligence for agents and reviewers

Prepared by: Oluwasegun Olumbe
Status: v1.0.0 — impact-map and pullpass absorbed; ships impact, pass, pass-pr, and review
Category: Practical AI governance for developers

Built and maintained by Oluwasegun Olumbe for teams that want context before code changes, review prompts before merge, and less guessing in agent workflows.

About repoctx

repoctx is a local-first context system. It inspects repositories, builds code maps, creates task-aware context packs, prepares PR review harnesses, and exposes the same workflow through an MCP server.

It keeps the legacy dev-context command as an alias while making repoctx the canonical product name.

Documentation Pack

# Document Description Status
01 Context Foundation Repository inspection, maps, search, context packs, and harnesses Active
02 MCP and Agents MCP tools and agent-facing workflows Active
03 Contributor Governance Reviews, branch protection, CODEOWNERS, and contributor flow Active
04 Release Readiness SemVer, changelog discipline, CI, and release gates Active
05 Trust-Layer Demo repoctx plus PullPass as a repeatable review workflow Active
06 Builder-Founder Loop Session rhythm, evidence ledger, governance ladder, and next-action rule Active

What repoctx Provides

Current Capabilities

  • Repository inspection with languages, scripts, entrypoints, and git state
  • AST-backed JSON-first code maps for JavaScript, TypeScript, and Go projects
  • Local discovery, indexing, catalog search, and workspace reports
  • Task-aware context packs before agents plan or edit
  • PR review context from git diffs and optional GitHub comments
  • Go test-file detection for PullPass-style repositories
  • MCP tools for repository context, search, maps, and review workflows
  • Contributor-ready governance: CI, CODEOWNERS, templates, security, and release guidance

Context Flow

flowchart LR A[Repo or workspace] --> B[Inspect shape] B --> C[Map files and symbols] C --> D[Build context pack] D --> E[Agent or reviewer] E --> F[Change] F --> G[PR review context] G --> H[PullPass gate]

Quick Start

npm install -g @nugehs/repoctx
repoctx doctor

npm ci
npm run ci
node src/cli.js doctor

repoctx mcp

  • Context Before Change

    Generate the map an agent or reviewer needs before touching the code.

  • Search Across Local Repos

    Discover, index, catalog, and search local repositories without sending code to a hosted model.

  • PR Review Harness

    Turn diffs into review prompts, risk flags, changed domains, and test hints.

  • Governance Ready

    Pair repoctx with PullPass for a repeatable trust layer: context before change, validation before merge.

  • Public Demo Path

    Show the workflow end to end: context pack, focused change, PR review context, PullPass gate, human merge.

  • Company Adoption Case Study

    Package the trust layer for engineering leaders, platform teams, and AI governance reviewers.

  • Builder-Founder Operating Loop

    Keep every coding-agent session tied to context, focused change, visible gates, human decisions, and durable evidence.