Searchable codebase wikis and context for coding agents

python -m pip install "codenib[mcp,semantic]==0.2.0"
codenib wiki /path/to/your/repo

Local, open source, and no cloud required. CodeNib combines BM25 and dense codesearch, adds optional SCIP symbol graphs, and incrementally rebuilds repositoryindexes as commits change. The same index powers the Wiki, Dependency Map, Ask,and MCP tools instead of making every agent rediscover the codebase.

News

• 2026-08-05 — CodeNib 0.2.0. Build a static Wiki and reusable contextartifact once, then serve it through Pages or the official MCP package.Hybrid retrieval and managed SCIP/LSP providers ship in the same CLI.Release notes
• 2026-08-05 — SweRank recipe. RunSweRank retrieval andreranking over a local checkout. Example
• 2026-08-04 — Native repository explorer. CodeNib's planner now targetsthe SWE-Exploresource-region protocol.Validation
• 2026-08-03 — Native LocAgent policy.LocAgent runs directly on CodeNibviews without LocAgent, LiteLLM, or LlamaIndex dependencies.Support matrix
• 2026-08-02 — OrcaLoca SearchAgent.OrcaLoca's six-tool search loopnow reuses CodeNib's symbol graph.Support matrix

System Architecture

repository change
  -> materialize or repair affected views
  -> publish a capability-bearing manifest
  -> plan repository queries
  -> deliver bounded, source-linked context

On a later commit, CodeNib can reuse unchanged vector content and patchsupported graph transitions at file or symbol granularity. Unsupported,inconsistent, or unverified transitions fall back to a fresh build instead ofpublishing a partially updated view.

Quickstart

Requires Python 3.10+ and Git. The recommended local path includes the pinnedCodeRankEmbed model and serves hybrid BM25+dense retrieval:

python -m pip install "codenib[semantic]==0.2.0"
codenib doctor --require core --require wiki
codenib wiki /path/to/repository

codenib wiki selects the semantic route because the installed environmentcontains its dependencies. A smaller python -m pip install codenib==0.2.0installation selects the deterministic BM25 fallback and downloads no model.The 0.2 release notes record theupgrade boundary and verification evidence.

CodeNib detects the repository languages, builds a reusable index under~/.codenib/repositories, launches the local Wiki, and openshttp://localhost:3000. The wheel includes theproduction Wiki frontend, so normal use does not require Node.js or npm andthe target repository stays untouched. This command exercises the same compilerand serving runtime used by agents. Set CODENIB_HOME to relocate state.

Check the environment or index without opening the Wiki:

codenib doctor --require core --require wiki
codenib index /path/to/repository

For a structural view, CodeNib detects the repository languages and managesonly their package-level providers; operating-system and project prerequisitesremain explicit:

python -m pip install "codenib[graph]==0.2.0"
codenib toolchain install /path/to/repository --scope graph
codenib doctor /path/to/repository --require graph

Export that indexed commit as a serverless Wiki when a live Ask backend is notneeded:

codenib export /path/to/repository --output /tmp/repository-wiki

The export contains a versioned provenance manifest, precomputed Wiki pages,source citations, and available page-level dependency data. It contains noprovider credential; interactive Ask and runtime graph exploration remain onthe local or MCP serving path.

For a repository-hosted Wiki, CodeNib also ships a reusable GitHub workflowthat incrementally builds the same manifest, deploys the static site to Pages,and uploads the matching commit-addressed context artifact. Its defaultsemantic route builds BM25 and vector views with a cached local Hugging Facemodel and needs no API key. An explicit fast route avoids the model download;a BYO OpenAI-compatible endpoint can replace local embedding. Query-time searchremains in the local or MCP runtime. SeeGitHub Pages.The published BM25/vector artifact can then be verified against an exact localcheckout and served through MCP without rebuilding the repository views.

See theQuickstartfor ports, advanced indexing, and troubleshooting.

Serve An Agent

Install the MCP extra, build once, and serve the same repository manifest overstdio:

python -m pip install "codenib[mcp,semantic]==0.2.0"
codenib index /path/to/repository
codenib mcp /path/to/repository

The MCP server advertises search_context as its default ranked entry point,then exposes the underlying BM25, vector, graph, and navigation operations forexplicit control. It uses the compiled manifest to decide which calls have afresh backing view. An agent can therefore reuseavailable repository work instead of rebuilding context through unboundedgrep and read loops, while unavailable searches fail explicitly. BM25,semantic, regex, Zoekt, dependency, and static-navigation results retain sourcelocations for follow-up reads and citations. SeeMCP Serverfor client configuration and tool contracts.

The same planner is available directly to Python agents:

from codenib.agent import RepositoryContextExplorer

with RepositoryContextExplorer.from_repository(
    "/path/to/repository", policy="auto"
) as explorer:
    result = explorer.explore("where is request retry behavior implemented?", top_k=10)

Each result includes source-validated evidence plus the selected plan,capabilities, loaded views, fusion, graph, and reranking trace.

What CodeNib Provides

Language support varies by surface. The generatedcapability matrixrecords chunking, graph, incremental, and C++ decoder support.

Documentation

• Quickstart
• GitHub Pages
• MCP Server
• Agent Integrations
• RAG Models and Planner
• Benchmarks and Evaluation
• Web UI
• Language Capabilities
• Concepts and development guides

Build the documentation site locally with:

python -m pip install -e ".[dev]"
mkdocs serve

Development

git clone https://github.com/sysevol-ai/CodeNib.git
cd CodeNib
make dev
make test

The test suite is split into unit, integration, serial integration, core,graph-consumer, and slow tiers. SeeCI/CD beforerunning the credential- or toolchain-dependent tiers.

Status

CodeNib 0.1.0 is a developer preview. The CLI and manifest format are usable,but public interfaces may still change before a stable release. Historicalresearch artifacts retain their published dataset identifiers; the maintainedpackage, import namespace, commands, and repository use CodeNib. SeeNaming.

Citation

If you use CodeNib in your research, please cite ourarXiv paper:

@misc{yu2026codenibmultiviewdataserving,
      title={CodeNib: A Multi-View Data System for Serving Repository Context to Coding Agents},
      author={Zhongming Yu and Hengjia Yu and Boqin Yuan and Shuting Zhao and Yizhao Chen and Aryan Dokania and Mihir Jagtap and Jiayu Chang and Yitong Ma and Yash Jayswal and Wentao Ni and Hejia Zhang and Zhaoling Chen and Gangda Deng and Jishen Zhao},
      year={2026},
      eprint={2607.25431},
      archivePrefix={arXiv},
      primaryClass={cs.SE},
      url={https://arxiv.org/abs/2607.25431},
}

Project

Website · Changelog · Contributing

License

CodeNib is licensed under theApache License, Version 2.0.