opentraces CLI
opentraces пишет локальный журнал работы Claude Code, Codex и Pi, привязывает правки к коммитам и готовит наборы данных.
- 104 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Записи сессий могут содержать секреты и данные клиентов, а публикация включается явным решением.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/opentracesОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Записи сессий могут содержать секреты и данные клиентов, а публикация включается явным решением.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
opentraces — локальный слой доказательств для работы агентов: открытая схема и CLI. Через хуки сессий он захватывает, что агент видел, делал и менял, и складывает запись в приватное локальное хранилище: траектории, историю патчей, события контекста и блобы. Три связанные записи: Trace отвечает, что сделал агент, Trail показывает, какие правки дошли до коммита и пережили ли они ревью (`trail blame`, `trail graph`), Ctx восстанавливает то, что модель видела на каждом шаге. По журналу работают поиск, срезы, сигналы о потерях контекста, сравнение запусков и возобновление сессии. Отдельные рабочие процессы превращают траектории в строки наборов данных, а проверка безопасности запускается до публикации в Hugging Face Hub.
Для кого. Разработчикам, которые копят следы работы агентов для отладки, обучения и разбора ошибок и хотят держать эти данные у себя.
Подходит, если
- Нужно выяснить, какие правки агента пережили ревью и вошли в коммит.
- Сессию надо возобновить с тем контекстом, который модель видела на нужном шаге.
- Из рабочих сессий собирается набор данных для оценки или обучения.
- Два запуска агента надо сравнить по потерям контекста.
Не подходит, если
- Агентские сессии содержат секреты, а передавать их куда-либо нельзя.
- Нужна простая телеметрия без хранения содержимого сессий.
- Используется агент, не входящий в Claude Code, Codex или Pi.
Пример запроса к агенту
Покажи через opentraces, какие патчи моей последней сессии дошли до коммита, и выведи сводку потерь контекста.Ограничения
Журнал хранит траектории целиком, поэтому в нем могут оказаться секреты, учетные данные, внутренние пути и данные клиентов; авторы прямо предупреждают, что публикация снижает, но не убирает эту угрозу, и рекомендуют прочитать документацию по уровням безопасности до загрузки. Синхронизация с Hugging Face включается только по явному согласию. Схема и CLI молодые, у проекта лицензия NOASSERTION на GitHub, а поддерживаются сейчас три агента. Команда `opentraces uninstall` отключает все поверхности установки.
Как отключить. Выполните `opentraces uninstall`: команда снимает хуки и расширения для Claude Code, Codex и Pi. Затем удалите пакет (`pipx uninstall opentraces`) и каталог хранилища, если записи больше не нужны.
Частые вопросы
Как установить?
Выполните `pipx install opentraces`. Есть также `brew install JayFarei/opentraces/opentraces` и `npx skills add jayfarei/opentraces` для скилла.
Какие агенты поддерживаются?
Claude Code, Codex CLI и Pi, через хуки сессий и расширения.
Что такое Trace, Trail и Ctx?
Trace описывает, что сделал агент. Trail связывает патчи с коммитами. Ctx показывает, что модель видела на каждом шаге.
Уходят ли данные с моей машины?
Нет, пока вы явно не включите синхронизацию с удаленным хранилищем Hugging Face.
Как удалить?
Командой `opentraces uninstall`, затем удалите сам пакет тем способом, которым ставили.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыЛокальный компилятор траекторий: превращает историю сессий Claude Code и Codex в данные для обучения, задачи и проверки
Локальная доска и MCP-сервер для исследовательских агентов: каждый вывод привязан к запуску и коду, который его породил
Навык и веб-просмотрщик превращают логи Claude Code, Codex и Pi в карту решений агента со ссылками на исходные записи.
CLI читает локальные сессии Claude Code, Codex и Hermes, находит повторяющиеся сбои и готовит правки на ручное ревью
Общая доска для Claude Code, Codex и других агентов: вопрос, на котором встал агент, всплывает наверх за секунды.
Многоагентная обвязка с проверкой результата по артефактам: стоп-хуки, независимый судья и журнал событий для Claude Code, Codex, Cursor и других
Коротко о README
Журнал агентских сессий с привязкой правок к коммитам и воспроизведением контекста. Данные остаются локально, пока не включена синхронизация.