repowise documentation

September 4, 2026 · View on GitHub

Index your codebase once. Your agent stops greping, your team stops guessing which PR is dangerous, and both get their answers from the same place.

One index producing code health, a dependency graph, git history, generated docs, architectural decisions, and ten MCP tools

New here? Quickstart gets you indexed and connected to your agent in under five minutes, with no API key.


Pick your path

You areStart hereThen
A developer wiring up an AI agentQuickstartSupported agents · MCP tools · Hooks · Distill
Living in an editorVS Code extensionCodex · opencode
A team lead watching what shipsChange riskCode health · Bug history
Running many reposWorkspacesWorktrees · Auto-sync
Evaluating repowise to buy itCommercialSecurity & compliance · Benchmarks · Roadmap
ContributingArchitectureCONTRIBUTING

Get started

DocWhat it covers
start/QUICKSTART.mdInstall, index your repo, and connect your agent in under 5 minutes
start/USER_GUIDE.mdThe everyday guide: how the pieces fit and the workflows they support
start/DASHBOARD.mdEvery view in the local web dashboard, and what each one answers

Connect your AI agent

DocWhat it covers
agent/INTEGRATIONS.mdWhich agents are supported at what depth, generated from the code, plus the recipe for adding one
agent/MCP_TOOLS.mdThe ten task-shaped tools, what each answers, and worked multi-tool examples
agent/HOOKS.mdProactive delivery: context and warnings that arrive without the agent asking
agent/DISTILL.mdrepowise distill: compress noisy command output before your agent reads it
agent/VSCODE.mdThe VS Code extension: health in the gutter, risk before you push, dashboards in the editor
agent/CODEX.mdWiring repowise into the Codex CLI
agent/OPENCODE.mdWiring repowise into opencode

The intelligence layers

DocWhat it covers
layers/INTELLIGENCE_LAYERS.mdOverview of the five layers: graph, git, docs, decisions, code health
layers/CODE_HEALTH.mdDefect risk, maintainability, and performance from 49 deterministic detectors
layers/REFACTORING.mdConcrete, graph-aware refactoring plans (Extract Class, Move Method, Break Cycle)
layers/CHANGE_RISK.mdScore any commit or base..HEAD range 0-10 for defect risk
layers/BUG_HISTORY.mdWhich files and symbols actually get bug-fixed, and how recently
layers/TEST_INTELLIGENCE.mdCoverage ingestion, untested hotspots, and running only the tests a diff touches
layers/GRAPH.mdThe dependency graph: what is in it, how every edge is resolved, and how much to trust each one
layers/DECISIONS.mdArchitectural decisions mined from your repo and from your own agent sessions
layers/DEAD_CODE.mdUnreachable files, unused exports, and zombie packages by confidence tier
layers/SECURITY.mdThe local pattern scan: what the sixteen patterns catch, what they do not, and how far to trust the result
layers/LANGUAGE_SUPPORT.mdWhat works per language: 25 parsed to a full AST, 39 on the five-rung ladder
layers/WIKI.mdThe generated wiki: page types, what update re-renders, styles, output language

Scale it

DocWhat it covers
scale/WORKSPACES.mdMulti-repo intelligence: cross-repo contracts, co-changes, and federated MCP
scale/WORKTREES.mdLinked git worktrees seed their index from the base checkout, with no flags
scale/AUTO_SYNC.mdKeep the index fresh automatically on every commit
../docker/README.mdRunning repowise in Docker
../examples/Copy-paste walkthroughs (Codex setup and more)

Reference

DocWhat it covers
reference/CLI_REFERENCE.mdEvery command and flag
reference/CONFIG.md.repowise/config.yaml, health-rules.json, and environment variables
reference/COMPUTED_GLOSSARY.mdDefinitions for every computed metric and term repowise reports
reference/TELEMETRY.mdWhat anonymous telemetry collects, and how to turn it off
reference/UPGRADING.mdNotes for upgrading between versions
CHANGELOG.mdRelease history

Evidence

DocWhat it covers
BENCHMARKS.mdEvery published number with its sample size and its test: call-graph precision judged by a compiler we do not control, retrieval against the agent-context field, defect prediction against CodeScene, distillation, and the rows we lose

Teams & business

DocWhat it covers
business/COMMERCIAL.mdHosted tier, enterprise (on-prem, SSO/SCIM), and commercial licensing
business/SECURITY_COMPLIANCE.mdWhat leaves your machine, what gets stored, and the answers your security team wants
ROADMAP.mdWhat we are building next, what we are not building, and why there are no dates on it

Architecture & internals

How repowise is built, for contributors and the curious.

DocWhat it covers
architecture/ARCHITECTURE.mdThe system: package layout, pipelines, MCP server
architecture/code-health.mdHealth internals: marker computation and calibrated weights
architecture/graph-algorithms.mdEvery graph algorithm, the intuition plus the math
architecture/language-support.mdThe language pipeline and how the tiers work
architecture/chat.mdCodebase chat: agent loop, streaming, artifact panel
architecture/structurizr-export.mdExport the architecture as Structurizr DSL and render it anywhere
architecture/editor-files.mdHow CLAUDE.md and AGENTS.md get generated
architecture/deep-dives.mdSystems not covered elsewhere
architecture/pluggable-storage.mdThe capability seams: storage, graph, vector, CLI, MCP
design/theme-tokens.mdResolved design tokens and the WCAG contrast matrix