AI Observer CLI
Локальная панель для Claude Code, Codex CLI, Gemini CLI, Copilot и OpenCode: токены, стоимость, задержки и ошибки
- 283 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Читает файлы сессий агентов в домашней папке, где лежат тексты запросов и ответов, и копирует их метаданные в локальную базу
- Открывает порты 8080 и 4318 без описанной авторизации, при запуске в сети данные доступны всем, кто достанет до порта
Установка
- Работает в
Ручная установка
docker run -d -p 8080:8080 -p 4318:4318 -v ai-observer-data:/app/data --name ai-observer tobilg/ai-observer:latestПанель откроется на http://localhost:8080, приемник OTLP слушает порт 4318.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Читает файлы сессий агентов в домашней папке, где лежат тексты запросов и ответов, и копирует их метаданные в локальную базу
- Открывает порты 8080 и 4318 без описанной авторизации, при запуске в сети данные доступны всем, кто достанет до порта
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
AI Observer — один исполняемый файл с вебом, который принимает телеметрию OpenTelemetry от ИИ-ассистентов для кода и показывает ее на панели `http://localhost:8080`. Данные хранит встроенная база DuckDB, внешние сервисы не нужны. Запускается через Docker, Homebrew для macOS на Apple Silicon или готовый бинарник из релизов. Для Claude Code, Codex CLI и Gemini CLI есть два пути. Либо настроить экспорт OTLP на порт 4318, и тогда `ai-observer setup claude-code` подскажет переменные окружения вроде `CLAUDE_CODE_ENABLE_TELEMETRY=1`. Либо ничего не настраивать и запустить `ai-observer watch all`: программа сама следит за файлами сессий в `~/.claude/projects`, `~/.codex/sessions` и `~/.gemini/tmp` и подтягивает новые записи. Команда `ai-observer import all` загружает прошлую историю и считает стоимость по встроенным ценам. GitHub Copilot и OpenCode работают только через OTLP. На панели токены, стоимость, задержки API, доля ошибок и активность сессий обновляются через WebSocket. Можно собрать свои дашборды из виджетов перетаскиванием. Команда `ai-observer export` выгружает данные в Parquet, а `ai-observer delete` удаляет их за выбранный период.
Для кого. Разработчикам и командам, которые работают с несколькими ИИ-ассистентами и хотят видеть расход токенов и денег в одном месте на своей машине.
Подходит, если
- Счет за Claude Code и Codex растет, а понять, какие сессии съели бюджет, нельзя
- Нужна общая панель по Claude Code, Codex CLI, Gemini CLI и OpenCode без отправки телеметрии сторонним сервисам
- Настраивать экспорт OTLP лень: достаточно `ai-observer watch all`, чтобы читать файлы сессий
- За прошлые месяцы накопились логи, и надо задним числом посчитать стоимость
- Данные требуется заархивировать в Parquet и передать коллеге для анализа
Не подходит, если
- Нужен облачный сервис с учетными записями и общим доступом команды: AI Observer рассчитан на одну машину и локальную базу
- Достаточно разового отчета в терминале по логам Claude Code: проще `ccusage`
- Работаете с агентами, которых нет в списке: поддерживаются Claude Code, Codex CLI, Gemini CLI, GitHub Copilot и OpenCode
- Нужны стоимости точно по счету провайдера: цены в программе встроены и могут отставать от тарифов
Пример запроса к агенту
Запусти AI Observer в Docker, подключи наблюдение за моими сессиями Claude Code и Codex и покажи, сколько я потратил за этот месяцОграничения
- Поддерживаются пять инструментов: Claude Code, Codex CLI, Gemini CLI, GitHub Copilot и OpenCode. Для Copilot и OpenCode нет чтения файлов, нужен экспорт OTLP.
- Стоимость считается по встроенной таблице цен моделей. Если тариф изменился, расчет отстает до обновления программы.
- Homebrew-пакет только для macOS на Apple Silicon, на остальных системах берите Docker или бинарник.
- Панель и порты 8080 и 4318 рассчитаны на локальный доступ. При открытии наружу нужна своя защита, встроенной авторизации в описании нет.
Как отключить. Остановите контейнер командой `docker stop ai-observer` или завершите процесс. Уберите из окружения переменные OTLP, например `CLAUDE_CODE_ENABLE_TELEMETRY` и `OTEL_EXPORTER_OTLP_ENDPOINT`. База лежит в `./data/ai-observer.duckdb` или в томе Docker, ее можно удалить. Данные за период стирает `ai-observer delete all --from ДАТА --to ДАТА`.
Частые вопросы
Как запустить AI Observer?
Самый короткий путь: `docker run -d -p 8080:8080 -p 4318:4318 -v ai-observer-data:/app/data --name ai-observer tobilg/ai-observer:latest`, затем откройте `http://localhost:8080`. На Mac с Apple Silicon доступны `brew tap tobilg/ai-observer` и `brew install ai-observer`.
Как подключить Claude Code?
Выполните `ai-observer setup claude-code` и задайте показанные переменные, среди них `CLAUDE_CODE_ENABLE_TELEMETRY=1` и адрес `OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318`. Либо запустите `ai-observer watch claude-code` и экспорт не понадобится.
Можно ли увидеть расходы за прошлые месяцы?
Да, для Claude Code, Codex CLI и Gemini CLI. Команда `ai-observer import all` читает файлы сессий и считает стоимость. Флаг `--dry-run` сначала покажет, что будет импортировано, а `--from` и `--to` ограничат период.
Уходят ли данные во внешние сервисы?
По описанию проекта нет: телеметрия остается в локальной базе DuckDB, внешние сервисы не требуются.
Как перенести данные в другой инструмент?
Команда `ai-observer export all --output ./export` сохраняет данные в Parquet-файлы. Для Claude Code, Codex и Gemini есть и режим `--from-files`, а Copilot и OpenCode выгружаются из базы.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыCLI-трассировка сессий Claude Code, Cursor и Codex через OpenTelemetry: что агент реально делал и сколько это стоило
Расход токенов и денег по Claude Code, Gemini CLI, Codex и Cursor в одном отчете: по локальным логам, без сети и ключей.
Tokscale
tokscale
CLI с интерактивным TUI для учета расхода токенов и стоимости работы AI-кодинг-агентов: Claude Code, Codex, Copilot, Cursor и других
Локальный сборщик телеметрии ИИ-агентов: токены, сеансы и вызовы инструментов в единой схеме событий OpenTelemetry
Claude Usage
claude-usage
Локальная панель по логам Claude Code: токены, модели, сессии и проекты. Подписчикам Pro и Max показывает полную картину вместо шкалы
Token Monitor
token-monitor
Настольный виджет учета токенов, стоимости и лимитов для 43 и более инструментов: Claude Code, Codex, Cursor, OpenRouter и других, для Windows и macOS
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| AI Observer (эта карточка) | нет | 283 | |
| ccusage | нет | 19 337 | отчеты в терминале по локальным логам, а AI Observer ведет веб-панель с OTLP, историей и своими дашбордами |
| Claude Code Agent Monitor | нет | 1 152 | панель для Claude Code и Codex, AI Observer охватывает также Gemini CLI, Copilot и OpenCode |
Коротко о README
Страница объясняет, зачем нужна наблюдаемость для ассистентов, перечисляет возможности и дает четыре способа запуска: Docker, Homebrew, бинарник и сборка из исходников. Дальше идут переменные окружения, таблица команд, подробности импорта, экспорта и режима наблюдения за файлами и настройки Claude Code, Gemini CLI, Codex, Copilot и OpenCode.