neatroots CLI
Локальный разбор прогонов вашего ИИ-агента: проверки, трассы и повтор вызовов, а Claude Code и Codex получают 23 MCP-инструмента.
- 80 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Сервис принимает трассы с содержимым промптов, повторяет вызовы моделей, а инструмент `query_sql` читает локальную базу прогонов.
Установка
- Работает в
Ручная установка
curl -fsSL https://raw.githubusercontent.com/neatlogs/neatroots/main/install.sh | shЗатем `neatroots start` и `neatroots connect` для подключения агентов. Windows через WSL.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Сервис принимает трассы с содержимым промптов, повторяет вызовы моделей, а инструмент `query_sql` читает локальную базу прогонов.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
neatroots запускается на ноутбуке, принимает трассы разрабатываемого агента через SDK Neatlogs, OpenTelemetry по OTLP или HTTP и хранит их в SQLite. Правила в коде ищут циклы, повторы вызовов, серии ошибок, утечки ключей и пустые прогоны. Вопросы «да или нет» отвечает локальная модель решений, а объяснение ошибки с предложением правки пишет LLM. Прогон показан четырьмя способами: обзор как чат, дерево трассы, временная шкала и разговор по сессии. Один вызов LLM можно повторить с измененным сообщением, моделью или системным промптом. Команда `neatroots connect` подключает Claude Code, Codex, Cursor и еще шесть клиентов по MCP: 23 инструмента читают прогон, объясняют его, сравнивают прогоны, создают проверки и повторяют вызовы. Для Claude Code и Codex добавляются четыре навыка.
Для кого. Разработчикам ИИ-агентов, которые отлаживают сбои на своей машине и хотят передать готовые улики кодирующему агенту для исправления.
Подходит, если
- Агент сообщил об успехе после неудачного вызова инструмента, и нужно найти этот прогон.
- Один шаг с ошибкой повторяют с другой моделью, не запуская агента целиком.
- Серию повторных вызовов инструмента превращают в правило, которое ловит ее дальше.
- Прогоны из облака Neatlogs загружают на ноутбук для разбора.
Не подходит, если
- Нужна постоянная мониторинг-платформа для продакшена: neatroots рассчитан на разработку.
- Ничего нельзя ставить через скрипт установки с `curl`.
- Работа идет на Windows без WSL: поддержки нет.
Пример запроса к агенту
Исправь то, что neatroots нашел в моем последнем прогоне, и добавь проверку, чтобы такой сбой ловился в следующий раз.Ограничения
Работает на macOS и Linux (arm64 и x64), на Windows через WSL. Установщик кладет пакет около 17 МБ в `~/.neatroots`, использует ваш Node.js 22 или новее, а при его отсутствии скачивает собственный. Модель решений Laya весит около 1,4 ГБ и скачивается один раз по желанию. Локальные вопросы и объяснения требуют LLM, по умолчанию локальная через Ollama, а при включении облачной модели содержимое прогона уходит провайдеру без секретов. Отправка в Neatlogs Cloud и подсказки для работающего агента включаются отдельно. Инструменты `replay` и `rerun` повторно вызывают модели и могут стоить денег.
Как отключить. Остановите службу `neatroots` и удалите каталог `~/.neatroots` вместе со ссылкой в `~/.local/bin`. Записи `neatroots` в MCP-настройках клиентов уберите вручную.
Частые вопросы
Как попробовать без ключей API?
Запустите `neatroots mock-llm` и пример из `~/.neatroots/app/examples`: макет модели понимает API OpenAI и Anthropic. Откройте `http://localhost:4100` и найдите прогон.
Какие агенты подключаются по MCP?
Claude Code, Codex, Cursor, OpenCode, Windsurf, Amp, Gemini CLI, VS Code и Claude Desktop. Для остальных клиентов есть `http://localhost:4100/mcp` и `neatroots mcp` по stdio.
Что уходит из машины?
Ничего, пока вы сами не отправите прогон или не включите облачную модель. Тогда содержимое, нужное задаче, уходит провайдеру с удаленными секретами.
Какие трассы принимает?
Из SDK Neatlogs (Python, TypeScript, Go, браузер), из HTTP API или любой экспорт OpenTelemetry по OTLP. Файлы трасс можно импортировать.
Нужна ли локальная модель?
Правила работают без модели. Для вопросов и объяснений нужен LLM: по умолчанию локальный через Ollama или облачный, который включают командой `neatroots llm login`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыagentevals оценивает поведение ИИ-агента по его OpenTelemetry-трассам и отдает MCP-инструменты и навыки /eval и /inspect.
Официальный CLI платформы Antithesis с MCP-сервером: агент запускает прогоны, читает свойства, логи и события, проверяет compose
CLI проверяет ИИ-агентов целиком: выводит сценарии из кода, гоняет на живом агенте и отделяет непроверенное от провала.
Локальный прокси и просмотрщик трафика для кодинг-агентов: показывает системные промпты, вызовы инструментов и расход токенов Claude Code, Codex и других CLI
Агент получает живую сессию вашего приложения на вебе, iOS или Android, видит экран, пишет тесты и сам проверяет правки.
Скилл учит Claude Code и Cursor подключать трассировку Tracely и превращать провальные запуски агента в тесты для CI
Коротко о README
Описаны возможности, схема потока данных, установка, пример за две минуты без ключей, отправка прогонов, подключение кодирующих агентов, выбор моделей и режим подсказок работающему агенту. В конце приведена таблица команд.