# OpenVisio

> Turn any repo into a code map your AI agent can query — it grabs the right files instead of burning tokens on the whole repo. Local via MCP, visual on the web.

OpenVisio parses any repository with tree-sitter into a code knowledge graph
(files, symbols, imports, calls — PageRank-ranked), serves it to AI coding
agents over MCP, and renders the same graph as an interactive visual map
(3D city, atlas, dependency views) with a narrator that cites exact path:line.
Indexing is deterministic (no LLM) and local-first: nothing leaves the machine.
The CLI and MCP server are MIT-licensed open source.

Quick start: `npm install -g openvisio`, then run `openvisio` inside a repo —
it writes the MCP config for Claude Code / Cursor / VS Code and runs the first
index. Or try without installing: paste a GitHub URL at https://openvisio.io/workspace

## Docs

- [Documentation](https://docs.openvisio.io/): setup, the graph, MCP tools, the narrator

## Guides

- [Why AI coding agents burn tokens — and how a code map fixes it](https://openvisio.io/guides/reduce-ai-agent-token-usage): the token math behind agent file-crawling
- [How to Give Claude Code Full Codebase Context (MCP Code Graph)](https://openvisio.io/guides/give-claude-code-codebase-context): Stop Claude Code from crawling your repo file by file. OpenVisio serves a queryable code graph over MCP — setup takes two commands, and tokens drop 30–90× on discovery.
- [How to Give Cursor Full Codebase Context (MCP Code Graph)](https://openvisio.io/guides/give-cursor-codebase-context): Stop Cursor from crawling your repo file by file. OpenVisio serves a queryable code graph over MCP — setup takes two commands, and tokens drop 30–90× on discovery.
- [How to Give Codex Full Codebase Context (MCP Code Graph)](https://openvisio.io/guides/give-codex-codebase-context): Stop Codex from crawling your repo file by file. OpenVisio serves a queryable code graph over MCP — setup takes two commands, and tokens drop 30–90× on discovery.
- [How to Understand a Large TypeScript Codebase Fast (Visual Map)](https://openvisio.io/guides/understand-large-typescript-codebase): Map any TypeScript repository into an interactive dependency graph — files, symbols, imports, hotspots — in your browser in seconds. Local, deterministic, free.
- [How to Understand a Large Python Codebase Fast (Visual Map)](https://openvisio.io/guides/understand-large-python-codebase): Map any Python repository into an interactive dependency graph — files, symbols, imports, hotspots — in your browser in seconds. Local, deterministic, free.
- [How to Understand a Large Go Codebase Fast (Visual Map)](https://openvisio.io/guides/understand-large-go-codebase): Map any Go repository into an interactive dependency graph — files, symbols, imports, hotspots — in your browser in seconds. Local, deterministic, free.
- [How to Understand a Large Java Codebase Fast (Visual Map)](https://openvisio.io/guides/understand-large-java-codebase): Map any Java repository into an interactive dependency graph — files, symbols, imports, hotspots — in your browser in seconds. Local, deterministic, free.
- [How to Understand a Large Rust Codebase Fast (Visual Map)](https://openvisio.io/guides/understand-large-rust-codebase): Map any Rust repository into an interactive dependency graph — files, symbols, imports, hotspots — in your browser in seconds. Local, deterministic, free.
- [How to Understand a Large PHP Codebase Fast (Visual Map)](https://openvisio.io/guides/understand-large-php-codebase): Map any PHP repository into an interactive dependency graph — files, symbols, imports, hotspots — in your browser in seconds. Local, deterministic, free.

## Comparisons

- [OpenVisio vs CodeSee](https://openvisio.io/compare/codesee-alternative): CodeSee was sunset after the GitKraken acquisition. OpenVisio is the open-source alternative: a live codebase map for humans plus an MCP code graph your AI agent can query.
- [OpenVisio vs Repomix](https://openvisio.io/compare/repomix-alternative): Repomix packs your whole repository into one AI-friendly file. OpenVisio builds a queryable code map instead, so your agent reads the right files — not all of them.
- [OpenVisio vs Serena](https://openvisio.io/compare/serena-alternative): Serena gives agents LSP-backed symbol tools. OpenVisio serves a pre-computed code graph over MCP — plus a visual map humans can read. Honest comparison inside.
- [OpenVisio vs CodeGraph](https://openvisio.io/compare/openvisio-vs-codegraph): CodeGraph and OpenVisio both give AI agents a pre-indexed code graph over MCP. The difference: OpenVisio’s graph is also a visual map humans can explore.
- [OpenVisio vs Sourcegraph](https://openvisio.io/compare/sourcegraph-alternative): Sourcegraph is enterprise cloud code intelligence. OpenVisio is the local-first alternative: a deterministic code graph your AI agent queries over MCP, plus a visual map.
- [OpenVisio vs DeepWiki](https://openvisio.io/compare/deepwiki-alternative): DeepWiki auto-generates wikis for public GitHub repos in the cloud. OpenVisio maps any repo — including private ones — locally, and serves the graph to your AI agent.

## Optional

- [Landing page](https://openvisio.io/)
- [Pricing](https://openvisio.io/pricing): free & open source; Pro ($7/mo) adds the grounded narrator
- [Try in the browser (no install)](https://openvisio.io/workspace)
- [Privacy policy](https://openvisio.io/privacy)