agent-improvement-loop CLI
CLI читает локальные сессии Claude Code, Codex и Hermes, находит повторяющиеся сбои и готовит правки на ручное ревью
- 73 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Скрипт читает транскрипты сессий целиком, в них бывают пути, команды и фрагменты кода из рабочих проектов
- Режим флота обменивается обезличенными пакетами между машинами, перед обменом их стоит просмотреть
Установка
- Работает в
Ручная установка
pipx install git+https://github.com/cathrynlavery/agent-improvement-loopТребуется Python 3.10 или новее. Вместо pipx подойдет uv tool install.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Скрипт читает транскрипты сессий целиком, в них бывают пути, команды и фрагменты кода из рабочих проектов
- Режим флота обменивается обезличенными пакетами между машинами, перед обменом их стоит просмотреть
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Ежедневный цикл самоулучшения для агентов. Скрипт собирает локальные транскрипты Claude Code из ~/.claude/projects, сессии Codex из ~/.codex/sessions и логи профилей Hermes, приводит их к небольшой модели событий с вызовами инструментов, командами оболочки, использованием скиллов, сбоями и поправками пользователя и вычищает чувствительные данные. Сигналы улучшений берутся из реального использования инструментов, слова в чате не считаются: фраза «не используй этот CLI» не считается отказом самого CLI. Результат ложится в ~/.agent-improvement/ как очередь предложений и читаемый пакет для ревью. Скиллы, память, регламенты, конфиги и исходники скрипт не правит: сканирование и постановка автоматические, применение остается ручным. Предложение, которое повторяется из прогона в прогон, поднимается в пакете выше остальных. Закрытые цели хранятся в реестре resolutions.json со статусом `fixed`, `wontfix` или `ignored`, и после fixed новое свидетельство попадает в раздел регрессий. В режиме флота каждая машина пишет обезличенный пакет, а один ведущий собирает их в общий отчет. Вторая половина системы, локальное хранилище `learnings` и скилл `learn-loop`, разбирает накопленные находки партиями до трех штук.
Для кого. Тем, кто ведет собственные скиллы, хуки и команды для Claude Code и Codex и хочет находить в журналах сессий то, что мешает чаще всего.
Подходит, если
- Одна и та же команда или инструмент падает в разных сессиях, и надо понять, в чем причина
- Накопилось много сессий за неделю, а скиллы и правила давно не обновлялись
- Несколько компьютеров с агентами и нужен один сводный отчет без выноса сырых логов
- Перед правкой CLAUDE.md или скилла нужны доказательства из реальных транскриптов
Не подходит, если
- Нужна автоматическая правка скиллов и конфигов: цикл ничего не применяет сам
- Нужен анализ качества ответов модели по содержанию: инструмент ищет сбои инструментов и поправки
- Сессии других агентов, кроме Claude Code, Codex и Hermes: другие форматы не читаются
Пример запроса к агенту
Просканируй мои сессии за последние сутки и покажи, какие сбои инструментов повторяются чаще всего.Ограничения
Нужен Python 3.10 или новее, внешних зависимостей нет. Скрипт читает ваши транскрипты целиком, а редактирование чувствительных данных делает автоматически, поэтому пакет для ревью стоит просмотреть до отправки куда-либо. Режим --full отключает вывод пакета для флота, чтобы необезличенные данные не попали в общий обмен.
Поддерживаются Claude Code, Codex и профили Hermes. Для флота нужен один ведущий компьютер: запускать несколько ведущих на одну общую очередь автор не рекомендует. Хранилище `learnings` держите вне Dropbox и других облачных папок с несколькими писателями. Последний коммит от 30 октября 2026 года.
Как отключить. Удалите клонированную папку или выполните pipx uninstall agent-improvement-loop. Каталог ~/.agent-improvement/ с очередью и реестром удалите вручную. Если ставили расписание, уберите задание cron или `launchd`, созданное скриптами `install_learnings_cron.py` и `install_learnings_launchd.py`.
Частые вопросы
Меняет ли agent-improvement-loop мои скиллы и конфиги?
Нет, цикл только читает транскрипты и пишет предложения в ~/.agent-improvement/. Применять правки вы решаете сами.
Как установить agent-improvement-loop?
Командой pipx install git+https://github.com/cathrynlavery/agent-improvement-loop, после чего доступна команда agent-improvement-loop. Подойдет и uv tool install, либо запуск прямо из клона через ./bin/daily-improvement-loop.
Как проверить результат, не записывая очередь?
Добавьте флаг --dry-run: предложения выводятся в JSON, а очередь и состояние не меняются.
Как закрыть разобранное предложение?
Командой --resolve с целью вида `tool:edge-cli` и решением `--decision fixed`, `wontfix` или `ignored`. После `fixed` новые свидетельства по цели попадают в раздел регрессий.
Можно ли читать сессии только Claude Code?
Да, флаг --source claude оставляет только сессии Claude Code, а --source codex только Codex.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыОдна конфигурация для Claude Code и Codex в любом репозитории: общие правила, пакеты скиллов, ревью второй моделью и защитный хук
CLI с панелью: находит сессии Claude Code, Codex, Gemini CLI и продолжает их в другом агенте как родные
Плагин самообучения для Claude Code, Codex и OpenCode: превращает исправления в правила, которым агент следует в следующих сессиях
ClawMetry читает файлы сессий агентов и показывает ход работы, вызовы инструментов, токены и стоимость в одной панели.
CLI ee дает агентам постоянную локальную память: правила, решения и антипаттерны с оценками и ссылками на источники
Команда session-recall читает локальные сессии агента и возвращает прошлые разговоры в сжатом виде, без MCP и хуков.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| agent-improvement-loop (эта карточка) | нет | 73 | |
| Coding Agent Session Search (cass) | нет | 1 205 | ищет по истории сессий разных агентов, этот сам выделяет повторяющиеся сбои и готовит очередь правок |
| Claude Session Dashboard | нет | 77 | показывает сессии Claude Code на панели, этот извлекает из них предложения по улучшению скиллов и инструментов |
Коротко о README
Небольшая локальная утилита на стандартной библиотеке Python, которая превращает историю работы агентов в очередь проверяемых улучшений. К ней приложены хранилище `learnings` с общим каталогом на нескольких машинах и скилл `learn-loop` для разбора находок.