# contextburn

Считает по локальным транскриптам Claude, какая часть оплаченных токенов стала выводом модели, а какая ушла на перечитывание контекста.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Автор: arsentev-ai
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/arsentev-ai/contextburn
- Обновлён: 2026-10-06
- HTML: https://affpapa.org/nevibecode/mcp/contextburn

## Что делает

contextburn разбирает транскрипты, которые Claude и так пишет на диск, и показывает долю токенов, превратившихся в вывод модели. Остальное — повторное чтение уже отправленного контекста. Счётчики токенов отвечают на вопрос «сколько я потратил», этот инструмент — на вопрос «сколько из этого было работой».

Числа две: доля по токенам и доля с учётом цены. Первая почти не двигается, потому что каждый шаг агента заново отправляет накопленный контекст. Вторая зависит от того, как вы ведёте сессии, ведь кэшированное чтение стоит дешевле свежего ввода и вывода. Цены по моделям лежат в начале файла `bin/contextburn`, их придётся обновлять руками.

Сам CLI — один файл на Python 3 без зависимостей, копируется в `~/bin`. MCP-сервер работает по stdio и даёт агенту два инструмента: `run_efficiency` с долями в структурированном виде и `spend_breakdown` с полным отчётом. Читаются только локальные транскрипты Claude из `~/.claude/projects/**/*.jsonl`, сетевых вызовов нет. Пока это работает лишь с транскриптами Claude — на других агентах считать нечего.

## Требования
- Нужно: Python и uv (команды через uvx)

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add contextburn -- uvx contextburn
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from contextburn <команда>

### Codex

**Командой платформы**
```bash
codex mcp add contextburn -- uvx contextburn
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from contextburn <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "contextburn": {
            "command": "uvx",
            "args": [
                "contextburn"
            ]
        }
    }
}
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from contextburn <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "contextburn": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "contextburn"
            ]
        }
    }
}
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from contextburn <команда>

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add contextburn uvx contextburn
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from contextburn <команда>

## Когда брать
- понять, какая часть оплаченных токенов стала выводом модели
- увидеть, сколько контекста агент перечитывает повторно
- сравнить эффективность длинной сессии и нескольких коротких
- дать агенту прочитать свою эффективность прямо посреди сессии
- следить за текущей скоростью расхода токенов

## Примеры запросов агенту
- Покажи мою эффективность прогона за последние 24 часа
- Разбери, что именно раздуло контекст в этой сессии
- Сколько токенов ушло на перечитывание, а сколько на вывод?

## Похожие
- [context-compression](https://affpapa.org/nevibecode/skills/context-compression.md) — скилл · 1400 установок
- [SuperCompress](https://affpapa.org/nevibecode/mcp/supercompress.md) — MCP-сервер · ★ 138
- [learn-codebase](https://affpapa.org/nevibecode/skills/learn-codebase.md) — скилл · 5300 установок
- [ctx-stats](https://affpapa.org/nevibecode/skills/ctx-stats.md) — скилл · 1800 установок
- [caveman](https://affpapa.org/nevibecode/skills/shawnchee-caveman.md) — скилл · 1100 установок
- [context-optimization](https://affpapa.org/nevibecode/skills/context-optimization.md) — скилл · 356 установок

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md