Documentation for the repository model.
Provenant is not a coding model. It is the system that turns a repository into a compact, measurable memory layer for agents.
Build a repository model
Index source, extract structure, generate repository pages, and make the codebase retrievable.
Retrieve context
Use search and context APIs to find the files, symbols, and pages an agent should read.
Understand the graph
Use Map to see files, symbols, entry points, and neighborhoods as a spatial memory.
Repair weak evidence
Turn low attribution into targeted regeneration instead of rebuilding everything.
Create the model once, update it when code changes.
Full model
Use full init when you want Provenant to generate repository documentation pages. This gives search and context assembly the strongest semantic retrieval surface.
provenant init .Structural model only
Use index-only when you want graph, symbols, search, and source inspection without LLM-generated pages.
provenant init . --index-onlyRefresh after edits
Use update after source changes. Add --docs when generated pages should be refreshed too.
provenant update --docsRun Provenant from the repository you want to inspect.
provenant serve starts the local API and the web UI. The browser UI talks to the API; if the API is offline, the shell will show a disconnected state.
provenant serveSearch first, then inspect context.
Ask the task
Describe what an agent needs to know before editing code. Good questions name the change, bug, or subsystem.
Read the packet
The ranked context is the product. It shows the pages Provenant thinks are worth sending to an agent.
Check the economics
Compare raw-source equivalent tokens with Provenant packet tokens. Savings only matter when attribution is healthy.
Good retrieval prompt
“Which files define request routing and endpoint registration?”
The graph is the spatial view of memory.
Repair changes the representation, not the source.
Detect
A packet retrieves pages that are not cited.
Select
Those pages become repair candidates.
Regenerate
Provenant rewrites the page from source.
Measure
Run the task again and compare attribution.
provenant improveWhere to go in the application.
Model
Start here. Shows whether the representation exists, how large it is, and what local trials have saved.
Map
A graph-first view of files, symbols, entry points, and adjacent context.
Search
Find representation pages, files, and symbols before opening source.
Repair
Where weak pages and low-confidence retrieval become specific interventions.
Risk
Inspect hotspots, ownership, blast radius, and change risk.
Dead Code
Find deletion candidates and unused code signals.
Agent API
HTTP endpoints and tool contracts for agents and external scripts.
Operations
Runtime, token, and local economics signals.
Use Provenant before reading source.
Agent flow
Search or ask first. Then request context for a small set of targets. Only open raw source when the packet points to a specific file or symbol.
MCP
Expose Provenant to an editor or coding agent when the agent should call repository tools directly.
provenant mcp .Commands and meanings.
provenant init .Build the model for the current repo.
provenant init . --index-onlyBuild fast structural indexes without generated docs.
provenant serveStart the API and web UI for the current repo.
provenant updateRefresh after code changes.
provenant update --docsRegenerate documentation pages too.
provenant improveRepair weak representation pages.
provenant mcp .Expose Provenant to an editor or agent through MCP.
When something feels wrong.
UI shows an old build
Stop serve, clear C:\Users\Shreyash\.provenant\web, then run provenant serve.
API disconnected
Start Provenant from the target repo. The UI needs the local API, usually on port 7337.
Graph is empty
The repo may not be initialized, or serve is running from the wrong directory. Run provenant init ..
Retrieval is vague
Use a more specific search question, inspect citations, then repair pages retrieved but not cited.