Codex Trace CLI
Codex Trace читает локальные журналы Codex CLI и показывает ходы, вызовы инструментов и расход токенов в окне или браузере.
- 120 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Установка запускает скрипт, скачанный командой curl, а журналы сессий могут содержать код и секреты.
Установка
- Работает в
Ручная установка
curl -fsSL https://raw.githubusercontent.com/PixelPaw-Labs/codex-trace/main/script/install-macos.sh | bashСтавит `Codex Trace.app` в `/Applications`, только Apple Silicon. Для Linux и Windows берите сборки из релизов.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Установка запускает скрипт, скачанный командой curl, а журналы сессий могут содержать код и секреты.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Программа открывает файлы сессий из `~/.codex/sessions/` и превращает сырой JSONL в читаемую переписку. Слева дерево сессий по датам, в центре ходы, справа подробности хода. Видны команды, вызовы MCP-инструментов, патчи, веб-поиск, события генерации изображений и связи между главным и рабочими сессиями. Есть поиск по сессиям и сообщениям, живое слежение за идущей сессией и показ токенов, где они записаны. Работает как настольное приложение на Tauri или как веб-интерфейс, в том числе в Docker. Данные никуда не отправляются, все читается с диска.
Для кого. Разработчики, которые ведут длинные сессии Codex CLI и разбирают, что агент сделал, где потратил токены и почему сломался шаг.
Подходит, если
- Сессия Codex ушла не туда, и нужно найти ход, с которого это началось.
- Хочется посмотреть, какие команды и патчи выполнил агент за вечер.
- Оркестратор запускает рабочие сессии, и их связи надо увидеть целиком.
- За идущей сессией следят из браузера на втором экране.
Не подходит, если
- Журналы нужны от Claude Code: для него есть claude-code-trace.
- Требуется облачная платформа наблюдаемости с командной работой.
- Формат журналов Codex CLI изменился после поддерживаемых версий.
Пример запроса к агенту
Открой последнюю сессию Codex в Codex Trace и найди ход, на котором агент начал править не те файлы.Ограничения
Читает только журналы Codex CLI в формате JSONL, поддержаны новые версии от 0.44, промежуточные и старый формат августа 2025. Однострочная установка на macOS скачивает приложение скриптом и работает на Apple Silicon, для Linux и Windows сборки берут в релизах. Токены видны только там, где Codex их записал. Журналы могут содержать код, пути и секреты из сессий, поэтому веб-режим держите на `127.0.0.1`. Последний коммит 31 октября 2026.
Как отключить. Удалите `Codex Trace.app` из `/Applications` или остановите контейнер. Журналы Codex в `~/.codex/sessions/` программа не меняет.
Частые вопросы
Где программа берет данные?
Из `~/.codex/sessions/ГГГГ/ММ/ДД/rollout-...jsonl`. Папку меняют в настройках по клавише `,`.
Можно ли запустить без установки приложения?
Да. Режим `npm run dev:web` из клона репозитория открывает интерфейс в браузере, а Docker запускает только веб-режим на порту 1422.
Видит ли программа журналы Claude Code?
Нет. Для них у тех же авторов указан отдельный проект claude-code-trace.
Отправляются ли данные наружу?
Нет, по описанию все читается локально и трассы во внешний сервис не уходят.
На каких системах работает?
На macOS, Linux и Windows. Одна команда установки рассчитана на macOS с Apple Silicon, остальным нужны сборки из релизов.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыПлагин Codex превращает локальные логи задач в таймлайн с токенами, временем инструментов и оценкой стоимости каждого шага.
Просмотр журналов Claude Code в читаемом виде: вызовы инструментов, токены и живой хвост сессии.
Codex MCP Tool (cexll)
Codex MCP Tool
MCP-сервер передает задачи Codex CLI из Claude Code и Cursor: разбор кода по ссылкам @, песочница, правки патчем, идеи
Веб-панель для сессий Claude Code и Codex на вашем компьютере: общий список, терминалы во вкладках, расход.
CLI на Go собирает сессии Claude Code, Codex, Copilot и других агентов в одну базу с поиском, TUI и MCP-сервером памяти
Читает локальные журналы Claude Code, Codex, Cursor и других агентов и показывает расход токенов, время и сбои в TUI
Коротко о README
Инструмент заточен под локальные журналы Codex CLI и не требует отправлять трассы во внешний сервис, в отличие от общих платформ наблюдаемости.