codemap CLI

Установка

Работает в

• Claude Code
• Codex

Ручная установка

brew tap JordanCoin/tap && brew install codemap

Что делает

codemap строит для агента карту репозитория и граф импортов. Агент и так видит, что написано в файле, но не видит, кто от него зависит: это следует из go.mod, членства в рабочем пространстве Cargo, карт экспорта в package.json и алиасов tsconfig. codemap разбирает их по правилам каждой экосистемы. Команда `codemap .` показывает дерево с главными файлами, `codemap --importers config/config.go` перечисляет зависящие от файла, а `codemap find "запрос"` ранжирует файлы по совпадению пути и символов и подписывает число импортирующих. Каждый ответ о зависимостях заканчивается строкой о покрытии: «complete», «partial» или «unavailable», с названием источника, которому нельзя доверять. Поэтому «ничто не импортирует этот файл» и «не удалось определить» читаются по-разному. Если сканирование завершилось по таймауту или с ошибкой, codemap возвращает пустой результат с пометкой источника. Команда `codemap setup` подключает все это к Claude Code и Codex: создает `.codemap/config.json` с языковыми фильтрами, дописывает хуки в `.claude/settings.local.json` и `.codex/hooks.json` и регистрирует MCP в `.mcp.json` и `.codex/config.toml`. Хуки дают контекст в начале сессии, перед правкой и при сжатии, а MCP-сервер с 19 инструментами запускается командой `codemap mcp` и подходит любому клиенту.

Для кого. Для разработчиков, у которых агент правит большие репозитории на Go, Rust, TypeScript, Python и других языках и должен знать заранее, какие файлы заденет изменение.

Пример запроса к агенту

Прежде чем менять config/config.go, выясни через codemap, какие файлы его импортируют, и скажи, насколько широко заденет правка

Ограничения

• Разбор зависимостей опирается на сторонний анализатор ast-grep. Homebrew ставит его сам, а в архиве релиза лежит только codemap: для CI нужен отдельный анализатор или сборка codemap-full.
• Если свежего графа нет, число импортирующих файлов в контексте остается пустым, а оценка опасности правки помечена unknown, чтобы не выдавать догадку за факт.
• После обновления бинарника интеграции с агентами остаются прежними, пока вы не обновите их вручную: выполните `codemap setup` в каждом проекте, а для Codex один раз `codemap plugin install`.
• `codemap doctor` проверяет исполняемые файлы, которые записаны в локальном конфиге проекта. Разработчик предупреждает, что в чужом репозитории такая проверка запускает выбранный им путь.

Как отключить. Уберите блок codemap из `.mcp.json` и `.codex/config.toml`, а хуки codemap из `.claude/settings.local.json` и `.codex/hooks.json`. Папку `.codemap` в проекте можно удалить. Фоновый наблюдатель включается отдельно командой `codemap watch start`, завершите его процесс, если запускали. Сам бинарник удаляется командой `brew uninstall codemap` или `scoop uninstall codemap`.

Коротко о README

Страница репозитория начинается с трех команд для первой минуты агента: поставить программу, выполнить setup и запустить MCP. Затем объясняется, зачем нужен граф зависимостей, и показан контракт покрытия с примером ответа в JSON. Дальше идут установка, правила разбора для Go, Rust, JS/TS и Dart, полный список команд и флагов и режимы разницы с веткой, потока зависимостей, радиуса влияния и «городского горизонта». В конце описаны хуки, 19 инструментов MCP, настройка проекта, встроенные скиллы, протокол контекста, HTTP API и передача работы между агентами.