Osnova
A deterministic tree-sitter code map for coding agents, with exact file and line over MCP
- Pricing
- Open source
- Platforms
- CLI, macOS, Linux
- Runs
- Locally
- Version
- 0.12.0
- Listing updated
- 1 day ago
About Osnova
Osnova is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.
Osnova turns a repository into a symbol and call graph so an agent can ask who calls a function and get exact file and line numbers with the evidence for each caller. Calls it cannot tie to a definition are listed separately as unresolved, with same-name candidates, so a name match is not mistaken for a caller. The same commit gives byte-identical output, and it uses no embeddings or telemetry and stays offline apart from an explicit update check.
It covers twenty languages, seven of them (TypeScript, JavaScript, Python, Go, Rust, Java and C#) with deep adapters. The osnova_warp tool reports callers, reach counts and tests touching a symbol, and Osnova can re-index a diff afterwards to show what a change reached. An optional search gate blocks grep-style searches on indexed code until an osnova tool has been used.
It needs Node.js 22.13 or newer and installs with one prompt for supported agents.
Install
Run in a terminal
claude mcp add osnova -- npx -y @getdomovoi/osnovaAdd to claude_desktop_config.json
{
"mcpServers": {
"osnova": {
"command": "npx",
"args": [
"-y",
"@getdomovoi/osnova"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"osnova": {
"command": "npx",
"args": [
"-y",
"@getdomovoi/osnova"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"osnova": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@getdomovoi/osnova"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"osnova": {
"command": "npx",
"args": [
"-y",
"@getdomovoi/osnova"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"osnova": {
"command": "npx",
"args": [
"-y",
"@getdomovoi/osnova"
]
}
}
}Configuration
OSNOVA_CACHE_DIRCache directory; the only place osnova writes.
Tools this server provides (1)
Taken from the project documentation; the running server may differ.
- osnova_warp
- Callers, reach and tests for a symbol with exact file and line
What it does
- Call graph answers
- Callers with file, line and the evidence for each.
- Unresolved evidence
- Unconfirmed calls listed apart with a reason.
- Deterministic output
- Same commit, same answer, byte for byte.
- Twenty languages
- Seven with deep adapters.
- Impact after edits
- Re-indexes a diff to show what a change reached.
- Optional search gate
- Steers agents to osnova instead of grep.
Good for
- Find all callers of a function before refactoring
- Give an agent exact edit locations
- Review the impact list of a change instead of the whole diff
- Run code intelligence offline
Pricing
Open source
Apache-2.0; free
Prices change. Check getosnova.dev before you buy.
Osnova FAQ
Does it send my code anywhere?
The README says no telemetry and no network unless you run osnova update-check.
What does it need?
Node.js 22.13 or newer.
What licence?
Apache-2.0.
How do I set it up for Claude Code?
Run osnova setup claude --apply after installing the npm package.
Is Osnova free?
Yes. Osnova is open source, so you can use and self-host it for free.
How do I add Osnova to Claude Code?
Run this command in your terminal: claude mcp add osnova -- npx -y @getdomovoi/osnova
What are the best alternatives to Osnova?
The closest alternatives to Osnova are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to Osnova

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools