ContextSpy CLI
Профилировщик контекста: прокси перехватывает запросы агента к модели и показывает состав каждого запроса и расход токенов.
- 67 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- Прокси перехватывает весь трафик агента к провайдеру, включая содержимое запросов и файлов, и сохраняет его в базу на диске.
- Команда `install-cert` меняет хранилище доверия операционной системы.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/contextspyОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Прокси перехватывает весь трафик агента к провайдеру, включая содержимое запросов и файлов, и сохраняет его в базу на диске.
- Команда `install-cert` меняет хранилище доверия операционной системы.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
ContextSpy запускает локальный HTTPS-прокси (для локальных моделей обратный), который перехватывает запросы кодирующего агента к API модели, разбирает их состав и сохраняет результат в локальную базу SQLite. Панель по адресу `http://127.0.0.1:5173` показывает сводки по сессиям и провайдерам, разбивку по моделям и задержкам, карту вызовов инструментов и рабочий стол запроса со сжатым, относительным и сырым видами. В карточке сессии ContextSpy восстанавливает разговор: продолжения, ответвления и блоки, которые сохранились, добавились, исчезли или были заменены. Агента запускают через прокси командой вроде `contextspy run claude`. Проверенные сочетания собраны на странице подтвержденных конфигураций; для Claude Code это API Anthropic на macOS и Windows. В README также названы Codex CLI, opencode и GitHub Copilot.
Для кого. Разработчикам, которые следят за расходом токенов и задержками в сессиях Claude Code, opencode или Codex CLI и ищут, что раздувает контекст.
Подходит, если
- Счет за API растет, и надо увидеть, сколько токенов уходит на системный промпт, скиллы и результаты инструментов.
- Сессия замедляется к двадцать пятому ходу, и нужно понять, какие блоки копятся в контексте.
- Подключили новый скилл или MCP-сервер и хотите измерить, сколько он добавил к каждому запросу.
- Нужно сравнить, как две сессии продолжают друг друга и где они ветвятся.
Не подходит, если
- Нужен постоянный мониторинг: автор рекомендует запускать ContextSpy на отдельных сессиях профилирования.
- Работа идет с конфиденциальными запросами: прокси сохраняет содержимое запросов и ответов в локальную базу.
- Агент или провайдер отсутствуют в списке подтвержденных конфигураций и важна гарантия работы.
Пример запроса к агенту
Запусти ContextSpy и сессию Claude Code через него, затем покажи, из каких блоков состоит самый большой запрос.Ограничения
Прокси видит весь трафик агента к провайдеру и сохраняет его локально, в том числе содержимое запросов. Облачный режим добавляет в систему сертификат командой `sudo contextspy install-cert`. Claude Code на Node игнорирует системное хранилище, поэтому требуется `NODE_EXTRA_CA_CERTS`. Данные сами не удаляются. Сессию можно заархивировать, а базу очистить командой `contextspy reset-db`. Из десктопного приложения Codex работает только Codex CLI.
Как отключить. Остановите прокси, выполните `contextspy reset-db`, удалите сертификат из системного хранилища и снимите пакет через `brew uninstall contextspy`. Агента запускайте без `contextspy run`.
Частые вопросы
Как поставить ContextSpy?
На macOS: `brew tap RimantasZ/contextspy`, затем `brew install contextspy`. Руководство по установке есть и для Linux, Windows и PyPI.
Как запустить агента через прокси?
Выполните `contextspy start`, а в другом терминале `contextspy run claude`, `contextspy run codex` или `contextspy run opencode <путь к проекту>`.
Отправляет ли ContextSpy данные в облако?
Нет. Все хранится на вашем компьютере, прокси и панель слушают только localhost.
Как очистить сохраненные запросы?
Заархивируйте сессию кнопкой Archive или командой `contextspy session archive`, а всю базу очищает `contextspy reset-db`.
Зачем нужна команда install-cert?
Прокси должен читать HTTPS-запросы, поэтому система обязана доверять его сертификату. Команда устанавливает сертификат один раз.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыCLI записывает сессии кодинг-агентов локально, повторяет ход работы и показывает, чего трасса не смогла доказать.
Локальная документация для агентов: MCP-сервер ищет в библиотеке пакетов документов по сотне библиотек и отвечает офлайн
HTTP-шлюз для Claude Code и Codex переключает API-подключения при ошибке и преобразует форматы запросов моделей
Context Engine — поиск по коду и память для агента
Context Engine
Скилл учит агента сначала обращаться к индексу кода и графу символов Context Engine и только потом читать файлы напрямую
MCP-сервер в одном бинарнике: ИИ читает и правит файлы нескольких проектов и запускает ваши команды
Ctxo строит граф зависимостей репозитория и дает агенту через MCP зону поражения изменения, историю коммитов и состояние кода
Коротко о README
Проект переводит расход контекста в наглядный профиль: сколько токенов тратится на какие блоки запроса и как они меняются между вызовами. Пакет выходит через Homebrew и PyPI под лицензией Apache 2.0, схема базы пока меняется между версиями.