archex CLI
CLI с локальным индексом кода: подписывает результаты grep и отдает агенту контекст с квитанцией о свежести индекса.
- 67 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- `install-client` записывает конфигурацию клиентов и по запросу хуки, а в репозитории создается каталог `.archex/` с индексом.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/archexОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- `install-client` записывает конфигурацию клиентов и по запросу хуки, а в репозитории создается каталог `.archex/` с индексом.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
archex строит локальный индекс репозитория и отдает кодирующему агенту проверяемый контекст. Хук после поиска (`grep`, `glob`, `rg` в оболочке) дописывает по одной строке на каждую единицу кода, в которую попали совпадения: имя, вид, диапазон строк и число импортеров. Сам результат поиска хук не меняет. Основной вызов для агента — `archex context "вопрос"`: он возвращает карту кандидатов, точные ссылки для запроса, выбранный код, цепочки связей, решение о маршруте и квитанцию со свежестью индекса. Есть интерфейсы CLI, MCP, API Python и Docker, скилл `/archex` для Claude Code и хуки для omp, Pi, OpenCode, Claude Code и Codex. MCP-сервер сначала показывает две схемы поиска, а после первого запроса открывает все 20 инструментов. Заявлена поддержка 26 языков, переносимые индексы для команды и анализ влияния изменения по диффу.
Для кого. Разработчикам, чьи агенты тратят много токенов на поиск по большому репозиторию и ошибаются в связях между модулями.
Подходит, если
- Агент после `grep` получает сотню совпадений, и нужна подпись, в каких функциях они находятся.
- Перед правкой надо узнать, кто импортирует модуль и что заденет изменение.
- Команде нужен общий готовый индекс репозитория, который не придется строить каждому заново.
- Нужно понять, свежий ли индекс и не пропущены ли файлы, прежде чем доверять ответу.
Не подходит, если
- Нужна работа на Windows без WSL: archex не поддерживается на родной Windows.
- Нужен чат-бот, который объяснит код: инструмент возвращает контекст для другого агента.
- Требуется доказанный выигрыш в доле решенных задач: автор такого замера пока не проводил.
Пример запроса к агенту
Найди через archex, где в проекте обрабатывается авторизация, и покажи, какие модули импортируют этот код.Ограничения
Работает на Linux и macOS, на Windows только внутри WSL. Замеров A/B на реальных задачах не проводилось, автор сообщает об этом сам: цифры экономии токенов относятся к фиксированной полноте на выбранных корпусах и не равны деньгам. Хук имеет бюджет 0,5 секунды, а на нагруженной машине задержка приближается к нему. Локальные метрики выключены по умолчанию и включаются командой `archex metrics enable`, телеметрии нет. Состояние лежит в каталоге `.archex/`, его не нужно коммитить.
Как отключить. Удалите хуки командой `archex install-client <клиент> --remove-hooks`, затем конфигурацию клиента и пакет через `uv tool uninstall archex`. Каталог `.archex/` в репозитории удалите вручную.
Частые вопросы
Как поставить archex?
Выполните `uv tool install archex`, затем `archex setup` в репозитории: команда строит индекс, проверяет MCP и спрашивает, настраивать ли найденные клиенты.
Как подключить к Claude Code?
Команда `archex install-client claude-code` записывает глобальную конфигурацию, флаг `--dry-run` показывает ее без записи. Для MCP-сервера нужен `uv tool install "archex[mcp]"`.
Как включить аннотации поиска?
Выполните `archex install-client claude-code --hooks`. Хук работает без блокировки, `--remove-hooks` его убирает.
Какие клиенты поддерживаются?
Claude Code, Codex, Cursor, OpenCode, Pi и oh-my-pi (`omp`) через `install-client`.
Собирает ли archex телеметрию?
Нет. Локальные метрики в `~/.archex/usage.sqlite` включаются отдельно и остаются на вашей машине.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыЛокальный семантический индекс кода: агент ищет по смыслу, затем идет к определениям, вызовам и путям зависимостей
Git-нативный контекст проекта для агентов: спецификации, решения и правила лежат в Markdown рядом с кодом и читаются перед правкой
Поиск по исходникам ранжирует совпадения с учетом структуры кода и дает агенту нужные фрагменты без отдельного индекса.
MCP-сервер индексирует локальный репозиторий через tree-sitter и дает агенту поиск по коду, список файлов и сводку по структуре файла
Локальный индекс кодовой базы для агентов: гибридный поиск, графы зависимостей и анализ последствий изменений
Локальный индекс кода для агентов: MCP-инструмент map ищет по смыслу и структуре, код не покидает машину
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| archex (эта карточка) | нет | 67 | ||
| open-codebase-index | нет | не нужна | 229 | локальный семантический индекс для поиска по смыслу; archex подписывает результаты обычного grep и выдает квитанции свежести |
| Serena | нет | не нужна | 31 335 | MCP-сервер с возможностями IDE; archex дает контекст и подписи к поиску без правки кода |
Коротко о README
Проект ставится через `uv`, индексирует код детерминированно и не вызывает модели при индексации. В README есть раздел с тем, чего авторы не заявляют, и инструкции для проверки приведенных цифр. Лицензия Apache 2.0.