SuperBased Observer CLI
Локальный бинарник считает затраты на Claude Code, Codex и Cursor по токенам провайдера и ставит защитные правила агентам.
- 58 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Инструмент читает журналы сессий с путями и командами, а необязательный прокси стоит между агентом и провайдером и видит запросы
Установка
- Работает в
Ручная установка
npx @superbased/observerРазовый отчет без установки, временная база удаляется при выходе. Постоянная установка: `npm install -g @superbased/observer`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Инструмент читает журналы сессий с путями и командами, а необязательный прокси стоит между агентом и провайдером и видит запросы
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Observer читает журналы сессий, которые агенты уже хранят на диске, и сводит их в одну локальную базу SQLite. Команда `npx @superbased/observer` без установки печатает таблицу расходов за 30 дней по инструментам и моделям и удаляет временную базу. Адаптеры охватывают Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Cline, Aider, Kiro, Devin, OpenCode и другие. Необязательный локальный прокси записывает токены, которые вернул провайдер: чистый ввод, запись кеша на 5 минут и на час, токены рассуждений. Поэтому видны точные суммы, а не оценки по журналам. Панель показывает окно кеша, диапазон стоимости следующего сообщения и шкалы лимитов. Защитные правила проверяют действия агента: разрушительные команды, утечку секретов, закрепление MCP и бюджеты. Они стартуют в режиме наблюдения, а `observer guard simulate` проигрывает историю до включения запрета.
Для кого. Разработчикам и командам, которые тратят заметные суммы на подписки и API агентов и хотят видеть расход по инструментам и моделям.
Подходит, если
- За месяц ушло неожиданно много токенов, и нужно понять, какой агент и модель съели бюджет
- Нужна проверка стоимости без установки: одна команда читает уже лежащие журналы
- Перед включением запретов хочется проиграть историю и увидеть, что правила заблокировали бы
- Кеш промпта истекает, и надо знать, когда следующее сообщение станет дороже
Не подходит, если
- Требуется мониторинг приложения на базе LLM: инструмент следит за кодирующими агентами, а не за вашим продуктом
- Нужен облачный сервис с учетной записью для команды, а локальная база вас не устраивает
- Политика запрещает локальный прокси между агентом и провайдером
Пример запроса к агенту
Покажи расходы за 30 дней по агентам и моделям и скажи, какие защитные правила сработали бы в моей истории.Ограничения
На macOS нужна версия 13 Ventura или новее, для macOS 12 README советует остаться на v1.36.0. Точные токены дает только прокси, а по журналам расходы оцениваются приблизительно. Содержимое сессий без явного согласия не отправляется, но база хранит пути, команды и короткие выдержки на диске, секреты перед записью вычищаются. Прокси и панель слушают `127.0.0.1`. Защитные правила стартуют в режиме наблюдения. Запуск агентов в терминалах панели и подключение с другого устройства через Tailscale включают отдельно. В метаданных GitHub лицензия не определена, README заявляет Apache-2.0.
Как отключить. Выполните `observer uninstall --all --purge`: команда уберет подключения и локальные данные. Если маршрутизировали агента через прокси, верните прежний адрес в его настройках.
Частые вопросы
Что делает команда без установки?
`npx @superbased/observer` читает журналы агентов на диске, печатает таблицу расходов за 30 дней по инструментам и моделям и удаляет временную базу.
Чем точнее прокси журналов?
Прокси записывает токены, которые вернул провайдер, включая запись кеша и токены рассуждений. По журналам их приходится оценивать.
Как подключить агента к прокси?
В панели откройте Compression, нажмите статус инструмента и выберите маршрут через прокси observer. Прокси передает ваши запросы провайдеру без изменений.
Где работают защитные правила?
Они проверяют действия агента по встроенным и вашим правилам. Режим наблюдения включен по умолчанию, а `observer guard simulate` показывает, что было бы заблокировано.
Есть ли доступ из VS Code?
Да, расширение `superbased.superbased-observer` добавляет строку состояния, боковую панель и вкладку с панелью. Для Cursor и Windsurf оно лежит в Open VSX.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыClawMetry читает файлы сессий агентов и показывает ход работы, вызовы инструментов, токены и стоимость в одной панели.
Локальная панель для Claude Code: граф сессий и субагентов, токены, стоимость и конфликты файлов в реальном времени.
Локальная панель учета работы ИИ-агентов: токены, оценка стоимости, шаги, измененные файлы и проверки по задачам Claude Code, Codex, OpenCode
Локальная панель мониторинга сессий Claude Code и Codex в реальном времени: активность агентов и вызовы инструментов
Терминальная панель с расходом, квотами и лимитами Claude Code, Codex, Cursor, Copilot и других ИИ-инструментов
Чтение кода, правки, тесты и ревью уходят параллельным воркерам на дешевых моделях, а главный агент получает короткий ответ и diff
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| SuperBased Observer (эта карточка) | нет | 58 | ||
| ccusage | нет | 19 415 | считает расходы по журналам Claude Code и Codex; Observer добавляет прокси с точными токенами и защитные правила | |
| CodeBurn | да | не нужна | 11 782 | локальный учет расходов и бюджеты; Observer охватывает 50 адаптеров и ведет проверку действий агентов |
Коротко о README
Данные живут в одном файле SQLite в `~/.observer/`, учетной записи нет. Расходы по умолчанию читаются из логов, а прокси включается отдельно ради точных цифр.