ProjectAtlas
Every file not opened. Every folder not explored. Tokens saved. A local repository map for coding agents: purposes, source, symbols, and dependencies. Native Ru
What is ProjectAtlas?
Every file not opened. Every folder not explored. Tokens saved. A local repository map for coding agents: purposes, source, symbols, and dependencies. Native Rust CLI and MCP, isolated worktrees, and subagent hooks.
Overview of ProjectAtlas
What it is
ProjectAtlas is a Rust-native CLI and MCP server that provides local repository intelligence for coding agents. It maintains a persistent SQLite map of folders, files, reviewed purposes, deterministic summaries, symbols, graph relationships, searchable text, health findings, and token telemetry. This map guides agents such as Codex, Claude Code, and OpenCode to the relevant code before they spend context reading the wrong files. According to the project's published audit, it can reduce token costs by over 90% in a specific workload, though this is a local estimate and not a universal savings guarantee. ProjectAtlas does not require .purpose files, source-header tax, hosted indexes, or credentials. Project state is stored beside the repository in a .projectatlas/ directory.
Key features
- Persistent SQLite map of folders, files, purposes, summaries, symbols, graph relationships, searchable text, health findings, and token telemetry.
.gitignore-aware scanning, BLAKE3 hashing, filesystem watching, and compact TOON output.- Agent-first design: purposes identify responsible areas, graph relationships reveal connected code, compact summaries and outlines explain selected files, and exact source slices provide evidence.
- No required
.purposefiles, no source-header tax, no hosted index or credentials. - Work across existing Git worktrees with short MCP aliases, including safe target hydration and labelled read-only federation.
- TUI dashboard (
projectatlas token --view tui) showing token impact, navigation work, source attribution, and calibration status (local snapshot, not provider billing). - Multiple installation routes: Codex plugin, native release, Cargo, and generated MCP configs for Claude Code/OpenCode.
Use cases
- Guiding coding agents to the correct code before they read broadly, reducing token consumption.
- Repository orientation and navigation for large codebases.
- Maintaining project-local intelligence with incremental updates via filesystem watching.
- Working across multiple Git worktrees from a single control checkout.
- Providing human overview of token impact and repository structure via the TUI.
Getting started
Install via the Codex plugin (recommended): bash codex plugin marketplace add styler-ai/ProjectAtlas --ref v0.4.5 codex plugin add projectatlas --marketplace projectatlas Then tell Codex: “Use ProjectAtlas for this repo.” Alternatively, install via Cargo: bash cargo install --git https://github.com/styler-ai/ProjectAtlas --tag v0.4.5 projectatlas-cli --locked Initialize a repository once: bash projectatlas init For other routes (native release, Claude Code/OpenCode), see the repository README.
License and pricing
License: MIT. Pricing: open source (free).
Based on the project's public README and repository metadata.