styler-ai/ProjectAtlas

解決的問題

ProjectAtlas 解決了代碼代理（如 Claude Code 或 Codex）在導航大型代碼庫時產生的高 token 成本與低效問題。與代理讀取整個目錄或無關檔案來尋找正確代碼不同，ProjectAtlas 提供一個本地的智能地圖，引導它們找到所需的精確代碼片段，從而顯著降低 token 消耗。

工作原理

它是一個原生 Rust 的 CLI 與 Model Context Protocol (MCP) 伺服器，在專案目錄中建立一個持久化的 SQLite 資料庫（.projectatlas/）。它會尊重 .gitignore，掃描倉儲以索引符號、圖關係、資料夾/檔案用途以及決定性摘要。代理透過 MCP 工具（例如 atlas_session_brief）查詢此地圖，以在讀取實際原始碼前縮小相關代碼範圍。

適用對象

在大型倉儲中工作並使用 AI 代碼代理（如 Codex、Claude Code 或 OpenCode）的開發者，希望降低 LLM token 成本並提升代理準確性。

主要亮點

• 高效率：使用 Rust 建構，實現快速索引與低延遲查詢。
• token 高效：透過提供緊湊的摘要與目標代碼片段，而非廣泛讀取檔案，旨在降低 token 成本。
• MCP 集成：原生支援 Model Context Protocol，可與相容的 AI 代理無縫整合。
• Git Worktree 支援：支援使用短別名在多個 Git worktree 之間進行追蹤與路由。
• 本地優先：無需託管索引或憑證；所有狀態皆本地儲存在 SQLite 中。