mcpField
C
CodeNib

CodeNib

Local
codenib.aiDeveloper Tools89Updated today

About CodeNib

CodeNib gives coding agents local code search and a typed symbol graph for navigating repositories with source-linked context. It is aimed at developers using Claude Code or Codex and supports multiple language graph backends.

Key features

  1. 01Ranked source-context search
  2. 02Typed symbol and dependency graph
  3. 03Trace callers, callees, and references
  4. 04Export source-cited Wiki pages
  5. 05Local setup without a model or API key

Use cases

  1. 01Locate implementation details in a repository
  2. 02Trace dependencies across code symbols
  3. 03Publish cited repository findings as a Wiki

MCP support

CodeNib includes an MCP integration that connects its local search and code graph to installed agent clients. Its MCP tools include `explore_context` and `dependency_subgraph`.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
"mcpServers": {
"ai-codenib-codenib": {
"command": "uvx",
"args": [
"codenib"
]
}
}
}
Run commanduvx codenib

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypicodenib0.2.4

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README
CodeNib

Find the right code. Trace the calls.

Give Claude Code and Codex source context and typed graph navigation across languages.

71.4% code-block Recall@5 on 100 real issues.
Model-planned grep → Jev: +12.8 percentage points over the same grep candidates without reranking.
Experimental result · Method and limitations

Use with your agent  ·  Browse a Wiki  ·  Languages  ·  Reproductions  ·  Releases

CI PyPI version Latest GitHub Release arXiv paper Hugging Face: #1 Paper of the Day Apache 2.0 license

Play a recorded Claude Code session on Requests: explore_context finds where authentication is stripped on redirects, then one dependency_subgraph call traces the four-hop caller chain from the public API

▶ Watch the 15-second replay · real CLI output · waits condensed · Pinned source, transcript and setup details.

Quickstart

Requires Python 3.10+, Git, a clean repository, and Claude Code or Codex.

python -m pip install "codenib[graph,mcp]"
codenib codegraph init /path/to/your/repo

Then ask your agent: “Use CodeNib's explore_context to find where request retry behavior is implemented. Cite the files and lines.”

This shipping path builds local search and a typed symbol graph, then connects installed agent clients. It needs no model, API key, or GPU for CodeNib; your agent uses its own model. It is separate from the grep/Jev experiment above. Language toolchain and project prerequisites vary.

Setup and troubleshooting · Source exclusions · All MCP tools · Local Wiki

Why CodeNib

  • Inspect the evidence. Retrieve bounded code context with file and line references, then follow callers, callees, definitions, and references.
  • Use the same tools across languages. The registry tracks 14 language entries, including 12 with graph backends. Check capability and setup differences in the language matrix.
  • Compare methods on the same source. Pinned agent contracts, datasets, and scorer checks make the reproduction surface inspectable.
  • Share what you found. Export a Wiki with source citations to your own GitHub Pages, or browse the public examples.

How it compares

What an agent can ask each tool, checked against upstream docs on 2026-09-28. This compares capabilities, not benchmark scores.

ToolAsk in plain languageCallers/callees beyond one hopRelationships resolved byRuns
grep / readNo; literal or regexNoText matchLocal
CodeNib CodeGraphYes; ranked source anchors (explore_context)Yes; one call, depth ≤ 8 (dependency_subgraph)SCIP/LSP indexers (compiler-resolved)Local
SerenaNo; symbol name or regexOne level per call (find_referencing_symbols)Live language server or IDELocal
CodeGraph (colbymchenry)Yes; FTS5 full-text (codegraph_explore)Yes; call paths in codegraph_exploreTree-sitter AST extractionLocal; telemetry opt-out
DeepWiki public MCPYes; generated answers (ask_question)No structured graph toolsGenerated WikiHosted

None of these repository tools needs its own model or API key; your agent uses its own model. Detailed comparison, sources and boundaries. CodeNib 0.2.4 also includes an optional grep → Jev route using OpenRouter for planning and reranking; selected code goes to remote models. Authorization previews remain opt-in. The historical research result above is separate from the product evaluation and the model-free CodeGraph row.

Languages

Graph backends: Python, Go, Rust, C/C++, C#, Java, Ruby, PHP, Kotlin, Scala, JavaScript, and TypeScript. Swift and Lua support chunking/retrieval. Provider prerequisites and coverage differ by language.

The generated language matrix separates chunking, graph backends, incremental-backend support, and decoder parity. The product currently reuses or rebuilds views; file-level delta repair is not enabled.

Results and reproductions

Start hereWhat you can inspect
Context methods and support matrixEvery retrieval pipeline, LLM workflow and agent route, sorted by the views it reads and who controls the search
BenchmarksLocalization, agent-context and resolution layers, evidence levels, and the method × benchmark matrix over CodeNib Base/Synthesis, SWE-bench Lite, Loc-Bench, SWE-Explore, Agent Retrieval Bench and ContextBench
grep → Jev result100-issue retrieval comparison, candidate controls, model use and limitations
Agent integration matrixRevision-pinned LocAgent, Agentless, CoSIL, OrcaLoca and RepoNavigator contracts; compatibility does not imply reproduced paper scores
SWE-Explore validation1,020/1,020 real-output metric cells match the pinned official evaluator on a fixed 20-case run
DGX Spark deploymentLocal Wiki, CodeGraph and model serving on GB10; a deployment guide, not a token-saving benchmark

Documentation and community

Documentation · Architecture · Contributing · CI and testing · Changelog · Discord

CodeNib is in beta; public interfaces may change before a stable release. Historical research artifacts retain their published dataset identifiers.

Citation

If you use CodeNib in your research, please cite our arXiv 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},
}

CodeNib is licensed under Apache 2.0.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.