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 .purpose files, 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.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/styler-aiprojectatlas.svg)](https://yunodb.com/tools/styler-aiprojectatlas?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/styler-aiprojectatlas?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/styler-aiprojectatlas.svg" alt="Featured on YunoDB" height="20"></a>