Bit Lantern
Local read-only code navigation for AI coding agents, built on a symbol index
- Pricing
- Freemium
- Platforms
- macOS, Windows, Linux
- Runs
- Locally
- Version
- 1.0.0-preview.30
- Listing updated
- 2 days ago
About Bit Lantern
Bit Lantern is a freemium MCP server for developer tools. It runs locally on your machine and is started by your AI client.
Bit Lantern works on the principle that an agent should not read a repository to answer a focused question about it. It builds one disposable SQLite index per workspace, at .bitlantern/index/symbols.db, holding symbols, signatures, exact source ranges and relationships such as imports, calls, inheritance and type use. The agent gets identifiers and coordinates, then reads only the ranges that matter with its normal file tools.
The index stays local and is kept out of git automatically. It honours .gitignore files even outside a git repository, and a .bitlanternignore file adds exclusions of its own. Exclusions are reported rather than silent, through symbol_schema. The documentation says it navigates code that already exists, so an empty new project gives it nothing to map, and it complements search, compilers and language servers instead of replacing them.
The software is proprietary, from Zaguan Labs, and the version documented is 1.0.0-preview.30. It grew out of the Symbols Index in Zaguan Blade and was previously called Atlas Scout. The registry lists native bundles for Apple silicon macOS, Linux on ARM64 and x86-64, and 64-bit Windows; the README notes that preview macOS and Windows binaries are not yet platform-signed.
Install
Run in a terminal
claude mcp add atlas-scout -- npx -y https://github.com/ZaguanLabs/atlas-scout-mcp/releases/download/v1.0.0-preview.30/bitlantern-mcp-1.0.0-preview.30-aarch64-apple-darwin.mcpbAdd to claude_desktop_config.json
{
"mcpServers": {
"atlas-scout": {
"command": "npx",
"args": [
"-y",
"https://github.com/ZaguanLabs/atlas-scout-mcp/releases/download/v1.0.0-preview.30/bitlantern-mcp-1.0.0-preview.30-aarch64-apple-darwin.mcpb"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"atlas-scout": {
"command": "npx",
"args": [
"-y",
"https://github.com/ZaguanLabs/atlas-scout-mcp/releases/download/v1.0.0-preview.30/bitlantern-mcp-1.0.0-preview.30-aarch64-apple-darwin.mcpb"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"atlas-scout": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"https://github.com/ZaguanLabs/atlas-scout-mcp/releases/download/v1.0.0-preview.30/bitlantern-mcp-1.0.0-preview.30-aarch64-apple-darwin.mcpb"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"atlas-scout": {
"command": "npx",
"args": [
"-y",
"https://github.com/ZaguanLabs/atlas-scout-mcp/releases/download/v1.0.0-preview.30/bitlantern-mcp-1.0.0-preview.30-aarch64-apple-darwin.mcpb"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"atlas-scout": {
"command": "npx",
"args": [
"-y",
"https://github.com/ZaguanLabs/atlas-scout-mcp/releases/download/v1.0.0-preview.30/bitlantern-mcp-1.0.0-preview.30-aarch64-apple-darwin.mcpb"
]
}
}
}Tools this server provides (1)
Taken from the project documentation; the running server may differ.
- symbol_schema
- Reports the index schema and the paths excluded from discovery.
What it does
- Structural code map
- Indexes every symbol, signature and exact source range, plus calls, imports, inheritance and type-use relationships.
- Bounded answers
- Returns definitions, ranges and references so the agent reads a few relevant lines instead of whole files.
- Local and disposable index
- A per-workspace SQLite index that is git-ignored and sends no code anywhere.
- Visible exclusions
- Ignore rules are honoured and excluded paths are reported through symbol_schema, capped at 256 entries.
- Edit-impact evidence
- The README lists static call relationships, architecture summaries and edit-impact evidence for connected agents.
- Free and Pro tiers
- Free covers symbol search, outlines and one-hop references; Pro adds deeper tracing, caller lists and a shared index.
Good for
- Find where a function is implemented without grepping the whole repo
- See which callers a refactor will affect before editing
- Pick the few files to read first in an unfamiliar codebase
- Answer how one module connects to another in a monorepo
- Cut the tokens an agent spends re-reading files
Pricing
Freemium, from $32.5 a month
Free forever; Pro $32.50/month billed yearly ($390) or $39 monthly, 14-day trial
Prices change. Check atlasscout.dev before you buy.
Bit Lantern FAQ
Does my code leave my machine?
The pricing page says Bit Lantern sends nothing of your code anywhere, with no account, key or telemetry on the Free tier.
What does it cost?
Free is $0 with no project limit. Pro is $32.50 a month billed $390 yearly, or $39 a month, with a 14-day trial that needs no card.
Is it open source?
No. Bit Lantern is proprietary; only the packaging metadata and build scripts in the repository are Apache 2.0.
Which platforms are supported?
Preview 30 ships for macOS 15 on Apple silicon, Linux on ARM64 and x86-64, and Windows 11 on x86-64.
Does it work on an empty project?
No. It maps existing code, so a brand-new project gives it little to return.
Is Bit Lantern free?
Bit Lantern has a free plan, with paid plans for more usage or features. Paid plans start at $32.5 a month.
How do I add Bit Lantern to Claude Code?
Run this command in your terminal: claude mcp add atlas-scout -- npx -y https://github.com/ZaguanLabs/atlas-scout-mcp/releases/download/v1.0.0-preview.30/bitlantern-mcp-1.0.0-preview.30-aarch64-apple-darwin.mcpb
What are the best alternatives to Bit Lantern?
The closest alternatives to Bit Lantern are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to Bit Lantern

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