ax CLI
CLI собирает историю сессий Claude Code и Codex в локальный граф, ищет по ней и превращает повторяющиеся ошибки в правки
- 123 ★ репозитория
- Последний коммит
- AGPL-3.0
Расширенный доступ
Почему такой уровень
- Читает транскрипты, историю git и вызовы инструментов, пишет локальный граф и по запросу правит файлы инструкций.
- Скрипт установки загружается из сети.
Установка
- Работает в
Ручная установка
curl -fsSL ax.necmttn.com/install | bashПервая команда раздела 60 seconds in; затем ax setup для скиллов, первого сбора и проверки.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Читает транскрипты, историю git и вызовы инструментов, пишет локальный граф и по запросу правит файлы инструкций.
- Скрипт установки загружается из сети.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
ax — петля ретроспективы для ИИ-агентов. Утилита читает транскрипты, историю git и вызовы инструментов в локальный граф на DuckDB и ничего не отправляет наружу. По графу можно искать (`ax recall "auth bug"`), смотреть, какие скиллы оправдали себя (`ax skills taste`), считать стоимость в токенах по ветке или коммиту (`ax costs`) и открывать панель `ax studio` на 127.0.0.1:1738. Главная функция: после сессии ax пишет структурную заметку «пробовали, сработало, не сработало, дальше», выводит из повторяющихся трений рекомендации для `AGENTS.md`, `CLAUDE.md` и скиллов и ведет принятые предложения как эксперименты с вердиктами через 3, 10 и 30 сессий. Агент, получивший заметки, читает, что сработало в прошлый раз.
Для кого. Тем, кто много работает с Claude Code и Codex и хочет, чтобы повторяющиеся ошибки агентов превращались в проверяемые правки файлов инструкций.
Подходит, если
- Агент снова и снова делает одну и ту же ошибку в проекте, и нужно найти закономерность.
- Надо вспомнить, в какой из прошлых сессий обсуждали баг авторизации.
- Хочется узнать, сколько токенов стоила ветка или коммит.
- Нужно решить, какие из установленных скиллов реально используются, а какие можно убрать.
Не подходит, если
- Нет Bun 1.3 или новее: утилита на нем построена.
- Нужна платформа для Windows: упор сделан на macOS, а Linux работает для сбора и CLI.
- Лицензия AGPL несовместима с вашей политикой: для таких случаев автор продает коммерческую лицензию.
Пример запроса к агенту
Запусти ax recall по теме retry loop и покажи три последние сессии, где агент упирался в одну и ту же ошибку.Ограничения
Нужен Bun 1.3 или новее, а граф хранится во встроенном файле DuckDB с небольшим дополнением на SQLite. Основная платформа macOS, на Linux работают сбор данных и CLI, а необязательный агент launchd для приема телеметрии только на macOS. Публикация профиля, виджета и вклад паттернов (`ax profile publish`, `ax profile widget`, `ax contribute pattern`) выходят наружу и включаются только явно. Принятые предложения ax записывает в файлы задач `.ax/tasks`, которые вы передаете агенту сами. Лицензия AGPL-3.0, коммерческая лицензия доступна отдельно. Последний коммит датирован октябрем 2026 года.
Как отключить. Удалите установленный бинарник `ax` из `~/.local/bin`, каталог данных с графом и скиллы, добавленные командой `ax setup`. Если ставили агент launchd для телеметрии, выгрузите его отдельно.
Частые вопросы
Что уходит наружу при работе ax?
Ничего по умолчанию: граф лежит локально, без аккаунта и облака. Наружу выходят только явные команды `ax profile publish`, `ax profile widget` и `ax contribute pattern`.
Как устроена петля ретроспективы?
После сессии `ax retro emit` пишет заметку, `ax improve recommend` ранжирует предложения, `ax improve accept` создает файл задачи, а `ax improve verdict` ставит вердикт через 3, 10 и 30 сессий.
Как посчитать стоимость?
Командой `ax costs summary --since=7` по провайдерам и моделям за неделю либо `ax costs for --commit <хеш>` по сессиям, стоящим за коммитом.
Как установить ax?
Командой `curl -fsSL ax.necmttn.com/install | bash`, затем `ax setup`. Можно вставить агенту промпт настройки, и он поставит ax сам.
Какую лицензию использует ax?
AGPL-3.0-only. Для случаев, которые AGPL не допускает, доступна коммерческая лицензия.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыclaude-history ищет и открывает прошлые диалоги Claude Code, Codex и Pi в терминале и дает Claude скилл для чтения истории
CLI и скилл /trajex: сессии Claude Code, Codex и Pi собраны в один SQLite-индекс, а агент ищет по ним запросами на JS
MCP-сервер и CLI, которые находят в сессиях Claude Code и Codex, почему файл стал таким: кто и о чем просил агента, когда и что изменилось
Скилл читает вашу историю промптов, находит повторяющиеся просьбы и превращает каждую в короткую команду вроде /sent
Локальный поиск по всем сессиям кодинг-агентов с возвратом в нужный CLI и статистикой расхода токенов.
Утилита aise ищет по локальной истории сессий Claude Code, Codex, Cursor и еще шести агентов и отдает ее агенту через MCP.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| ax (эта карточка) | нет | 123 | |
| claude-reflect | нет | 1 942 | извлекает уроки из сессий в память Claude; ax строит граф всех сред запуска и ведет эксперименты с вердиктами |
| Claude-Mem | нет | 116 457 | плагин памяти с автоматическим сжатием сессий; ax ищет по истории и предлагает правки инструкций |
Коротко о README
Показаны разделы про сбор истории из разных сред запуска, поиск по сессиям, оценку скиллов, учет стоимости, маршрутизацию дорогой модели и публикацию сессии. В тексте особенно подчеркнута локальность и согласие на каждый выход наружу.