NeMo Relay CLI
Прозрачная обертка для Claude Code и Codex: локальный шлюз пишет события запуска и траектории без правок агента.
- 234 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Шлюз встает между агентом и провайдером моделей и записывает ход сессии на диск.
- Постоянная установка добавляет хуки в Codex или Claude Code.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/nemo-relayОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Шлюз встает между агентом и провайдером моделей и записывает ход сессии на диск.
- Постоянная установка добавляет хуки в Codex или Claude Code.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
NVIDIA NeMo Relay — общий рантайм для наблюдения за запусками агентов и управления ими: области выполнения, события жизненного цикла, middleware на вызовах инструментов и моделей. CLI `nemo-relay` запускает Codex или Claude Code через локальный шлюз. Команды `nemo-relay claude -- "..."` и `nemo-relay codex -- exec "..."` поднимают шлюз на время сессии и подставляют хуки с настройками провайдера только для запущенного процесса, а после выхода агента выключают шлюз. На диск попадают сырые события ATOF в JSONL и траектории ATIF; их же можно отправить как трассы, логи и метрики OpenTelemetry. В репозитории лежат пользовательские скиллы в `skills/` (установка, первый запуск, инструментирование вызовов, отладка интеграции) и плагин для Claude Code.
Для кого. Разработчики агентных систем и команды, которым нужна запись реального хода сессий Claude Code и Codex для отладки и оценки.
Подходит, если
- Нужно увидеть, какие вызовы инструментов и моделей сделал Codex за сессию.
- Траектории сессий Claude Code идут в оценку качества в формате ATIF.
- Телеметрию агента отправляют в стек на OpenTelemetry.
- Агент сам разбирается, как подключить Relay к приложению, по скиллу `nemo-relay-get-started`.
Не подходит, если
- Нужна только запись терминала без разбора вызовов на события.
- Сессии идут в приложении Claude, веб-версии или Claude Desktop: поддерживается только Claude Code.
- Файлы с ходом сессии нельзя хранить на диске.
Пример запроса к агенту
Запусти Claude Code через nemo-relay с локальным экспортом ATOF и ATIF и покажи, какие файлы появились.Ограничения
Плагин для Claude Code требует Claude Code 2.1.121 или новее. Постоянная установка для Codex доверяет только хукам плагина `nemo-relay-plugin@nemo-relay-local`, после нее перезапустите приложение Codex. На Windows ограничивающий Job Object хоста может привязать шлюз ко времени жизни процесса хоста. Файлы событий и траекторий описывают реальный ход сессии, поэтому проверьте содержимое, прежде чем делиться ими.
Как отключить. Перестаньте запускать агента через `nemo-relay`; для постоянной установки удалите плагин в Codex или Claude Code. CLI, поставленный скриптом, удаляется по инструкции из документации.
Частые вопросы
Как записать сессию Claude Code?
Включите вывод ATOF и ATIF в `nemo-relay plugins edit` и запустите `nemo-relay claude -- "..."`. После выхода агента события лежат в `.nemo-relay/atof`, траектории в `.nemo-relay/atif`, если вы задали эти каталоги.
Чем ATOF отличается от ATIF?
ATOF — сырой поток событий, который Relay реально поймал. ATIF — нормализованная траектория для анализа и оценки; начинайте с проверки ATOF.
Нужен ли Relay отдельно для Hermes Agent?
Нет. NeMo Relay встроен в Hermes Agent, отдельный плагин наблюдаемости и установка CLI не нужны.
Какие языки поддерживает рантайм?
Python и Node.js ставятся через `uv add nemo-relay` и `npm install`, есть и пакеты на Rust. Это отдельный путь для приложений, которые сами вызывают модели и инструменты.
Какие скиллы лежат в репозитории?
В `skills/` собраны пользовательские скиллы: `nemo-relay-install`, `nemo-relay-get-started`, `nemo-relay-instrument-calls`, `nemo-relay-integrate-upstream`, `nemo-relay-plugin-observability` и `nemo-relay-debug-runtime-integration`, среди прочих.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыCLI-трассировка сессий Claude Code, Cursor и Codex через OpenTelemetry: что агент реально делал и сколько это стоило
Официальный CLI Coralogix с 19 скиллами: агент читает логи, трассы и метрики продакшена и разбирает инциденты в терминале
Локальная панель для параллельных сессий Claude Code и Codex: кто работает, кто ждет ответа, плюс 3D-аквариум и Stream Deck
Самостоятельно хостится центр управления агентами: Claude Code, Codex, Copilot, OpenCode и Pi с телефона, десктопа и терминала
CLI и оператор Kubernetes, который запускает Claude Code, Codex, Gemini, OpenCode и Cursor как задачи и сессии в кластере
Локальная панель для Claude Code, Codex CLI, Gemini CLI, Copilot и OpenCode: токены, стоимость, задержки и ошибки
Коротко о README
Relay дает общий слой для кодинг-агентов, приложений, фреймворков и бэкендов наблюдаемости. Готовы интеграции для Codex, Claude Code, LangChain, LangGraph, Deep Agents, Google ADK и OpenClaw; для Hermes Agent поддержка встроена.