cctop CLI
Терминальный монитор сеансов Claude Code: занятость, остаток контекста, память, процессы и сеансы, которые ждут ответа.
- 148 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Читает локальные файлы Claude Code и по команде завершает выбранный процесс сигналом `SIGTERM`.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/cctopОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Читает локальные файлы Claude Code и по команде завершает выбранный процесс сигналом `SIGTERM`.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
`cctop` собирает все запущенные сеансы Claude Code в одну таблицу, как `top` для процессов: PID, память, процессор, время работы, размер контекста, модель, проект, ветка git и последний запрос. Занятые сеансы окрашены зеленым, простаивающие красным. На экране видны подагенты и дочерние процессы с открытыми и осиротевшими TCP-портами. Клавиша `n` включает звонок и системное уведомление, когда сеанс закончил ход и ждет ответа, а `h` открывает историю расхода токенов по дням, моделям и проектам. Программа читает только `~/.claude` и таблицу процессов, а собственные настройки пишет в `~/.claude/cctop/`.
Для кого. Тем, кто держит параллельно несколько сеансов Claude Code в терминале или IDE и теряет, какой из них ждет ответа.
Подходит, если
- Десять окон Claude Code висят на экране, и неясно, какое из них закончило ход.
- Сеанс живет долго, и хочется следить, сколько контекста у него осталось.
- После закрытия агента на порту остался висеть dev-сервер.
- Разбирают расход токенов за неделю по моделям и проектам.
Не подходит, если
- Работа идет в одном сеансе, и таблица ничего не добавит.
- Сеансы запущены на другом компьютере: утилита читает локальные `~/.claude` и таблицу процессов.
- Нужен менеджер процессов с автоперезапуском: `cctop` показывает и по команде завершает сеанс.
Пример запроса к агенту
Покажи все сеансы Claude Code одним снимком в JSON и назови те, что простаивают и ждут ввода.Ограничения
Утилита работает только с Claude Code и читает его локальные файлы в `~/.claude`; другие агенты в таблице не появятся. Клавиша `x` посылает `SIGTERM` выбранному сеансу, а `f` освобождает порты, оставшиеся от dev-сервера, поэтому перед подтверждением стоит прочитать, какой процесс выбран. Уведомления через OSC 9 работают в iTerm2, Ghostty, kitty, WezTerm и Windows Terminal. Лимиты подписки покажутся только после добавления `cctop --capture-usage` в скрипт статусной строки Claude Code. Установочный скрипт рассчитан на macOS и Linux.
Как отключить. Удалите бинарный файл: `rm ~/.local/bin/cctop`, для Homebrew `brew uninstall stefanprodan/tap/cctop`. Если включали лимиты, уберите строку `cctop --capture-usage` из скрипта статусной строки; каталог `~/.claude/cctop/` с настройками удаляют вручную.
Частые вопросы
Как узнать, какой сеанс ждет ответа?
Нажмите `n`: когда сеанс закончит ход, cctop позвонит и покажет уведомление, а сам сеанс получит пустой кружок на 30 секунд. Клавиша `b` переходит к сеансу, который звонил последним.
Как получить данные для скрипта?
`cctop --json` печатает полные сведения о сеансах, а `cctop --once` выводит один кадр и завершается. При запуске в конвейере вывод тоже одиночный.
Как показать лимиты подписки?
Добавьте `printf '%s' "$input" | cctop --capture-usage || true` в скрипт статусной строки Claude Code. Значения за 5 часов и 7 дней сохраняются в `~/.claude/cctop/usage.json`, откуда их читает интерфейс.
Как скрыть лишние столбцы?
Перечислите нужные в ключе `columns` файла `~/.claude/cctop/settings.json`, например `["project", "branch", "last-action", "prompt"]`. Первые семь столбцов остаются всегда.
Обновляется ли программа сама?
Нет, обновление запускают командой `cctop upgrade`, а `cctop upgrade --check` только сообщает о новой версии.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыТерминальная панель в стиле top для сессий Claude Code и Codex: расход, токены, контекст, процессы и вызовы инструментов.
Панель мониторинга всех сессий Claude Code на машине: живые агенты, стоимость, поиск по истории и MCP-инструменты для Claude.
Локальная панель мониторинга сессий Claude Code и Codex в реальном времени: активность агентов и вызовы инструментов
Локальная панель для сессий Claude Code: таймлайны, расходы токенов, инструменты, агенты, скиллы и живые сессии
Среда для Claude Code, которая держит контекст между сессиями через хуки, леджеры и передачи, оркеструет агентов и экономит токены
Терминальное приложение для параллельной работы нескольких Claude Code, Codex, Gemini CLI и Aider в отдельных сессиях tmux и git worktree
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| cctop (эта карточка) | нет | 148 | |
| Claude Code Agent Monitor | нет | 1 145 | claude-code-agent-monitor выводит активность агентов и вызовы инструментов в локальной панели; cctop дает таблицу процессов сеансов с контекстом, портами и звонком |
| ccusage | нет | 19 337 | ccusage считает токены и стоимость отчетами по логам; cctop следит за живыми сеансами и процессами |
Коротко о README
Интерфейс не запускает процессов: он читает файлы Claude Code и таблицу процессов. Исключение составляет явная команда `cctop upgrade`, которая заменяет собственный бинарный файл.