ProjectAtlas CLI
Локальная карта репозитория для агента: CLI atlas и MCP ищут нужный код по назначению файлов, а не открывают все подряд.
- 484 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Индексирует исходники проекта в локальную базу, пишет проектную конфигурацию MCP и подключает хуки.
Установка
- Работает в
Ручная установка
codex plugin marketplace add styler-ai/ProjectAtlas --ref v0.5.0
codex plugin add projectatlas --marketplace projectatlasПервый вариант Install из README, для Codex.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Индексирует исходники проекта в локальную базу, пишет проектную конфигурацию MCP и подключает хуки.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
ProjectAtlas хранит карту репозитория в локальной базе SQLite внутри проекта: назначение папок и файлов, краткие сводки, символы и связи между ними. Агент идет по карте и открывает только нужные фрагменты кода. Нативный CLI `atlas` и MCP-сервер работают поверх одного индекса. Среди команд `atlas next`, `atlas summary`, `atlas symbols relations`, `atlas token`. Каждая рабочая копия git держит собственную карту, а MCP умеет обращаться к зарегистрированным копиям по короткому псевдониму.
Для кого. Тем, кто гоняет Codex или Claude Code по большому репозиторию и теряет контекст на поиске нужных файлов.
Подходит, если
- Агент перед правкой читает десятки файлов подряд, чтобы найти нужное место.
- Перед рефакторингом надо понять, что заденет изменение: вызовы, импорты, ссылки.
- Параллельно работают несколько агентов в отдельных git-worktree.
- Хочется видеть оценку экономии токенов командой `atlas token --view tui`.
Не подходит, если
- Репозиторий маленький, и агент находит нужный файл с первого раза.
- Нужны гарантии полного разбора динамического кода: граф описывает статические факты.
- Язык проекта слабо поддерживается: полный список в матрице языков репозитория.
Пример запроса к агенту
Используй ProjectAtlas для этого репозитория: найди, где реализовано обновление по `watch`, и покажи связанные вызовы.Ограничения
Граф строится по статическим фактам: неразрешенные ссылки и пределы покрытия остаются в ответе, поэтому кандидатов на мертвый код нужно проверять вручную. Пакет парсеров на 150 грамматик указан для Linux x64 и Windows x64. Данные об экономии токенов в README взяты из исторических замеров на фикстурах и модельных оценок, а не из счетов провайдера. Каждый репозиторий нужно один раз инициализировать командой `atlas init`, а после правок обновлять карту через `atlas watch --once`.
Как отключить. Удалите плагин или запись MCP из конфигурации агента и уберите каталог `.projectatlas` вместе с локальной базой из проекта.
Частые вопросы
Как поставить ProjectAtlas?
Попросите агента установить его из репозитория, лучше через плагин маркетплейса. Для Codex это `codex plugin marketplace add styler-ai/ProjectAtlas --ref v0.5.0`, затем `codex plugin add projectatlas --marketplace projectatlas`.
Нужен ли Rust для установки?
Нет. Бинарные релизы собраны для Windows x64, Linux x64, macOS Intel и Apple Silicon. Сборка из исходников идет через `cargo install`.
Где хранится карта?
В проекте, в локальной базе SQLite. Каждая рабочая копия git держит свою базу.
Как подключить к Claude Code?
Нативный установщик записывает проектную конфигурацию MCP для Claude Code и OpenCode. Подробности в руководстве `docs/agent-integration.md`.
Чем занят `atlas token`?
Показывает локальный отчет об экономии токенов. Отдельно считаются наблюдаемое сжатие исходников и модельная оценка навигации.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыMCP-сервер ведет карту смысла кода в Markdown рядом с репозиторием: агент читает контекст перед задачей и вносит предложения.
CLI строит индекс кодовой базы и карту на 250 токенов, чтобы агент не читал сотни файлов в поисках нужного.
MCP-сервер и CLI на Go: агент ведет в репозитории индекс кода и схемы базы, хранит его в Git и читает целиком перед каждой задачей
Локальный граф кода для агентов: MCP-сервер отдает точки входа, связи символов и радиус влияния изменений за один вызов
MCP-сервер и CLI для исследования кода: поиск и разбор по вашему проекту и по всему GitHub с экономией токенов
codesight за один запуск собирает карту проекта: маршруты, модели БД, зависимости, env-переменные. Отдает ее агенту файлами или через MCP-сервер
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| ProjectAtlas (эта карточка) | нет | 484 | ||
| CodeGraph | нет | не нужна | 76 797 | строит граф символов и связей кода; здесь карта опирается на назначение папок и файлов, на отдельные карты worktree и токен-отчет |
| GitNexus | нет | не нужна | 48 292 | индексирует кодовую базу в граф знаний для MCP; здесь основной интерфейс нативный CLI `atlas` с общим индексом для MCP |
Коротко о README
README ведет от идеи карты к командам, параллельной работе в worktree, замерам экономии токенов, языкам и установке.