CTOP: термінальний монітор для сесій Claude Code та AI-агентів
Відстежуйте локальні сесії агентів Claude Code, Codex CLI, OpenCode та Devin за допомогою CTOP — інтерактивної панелі в терміналі. Вона показує навантаження на процесор, пам'ять, витрату токенів, стан контексту та вартість API.
Вплив: Середній
Чому це важливо
AI-агенти для кодингу виконують важкі багатокрокові цикли у фоновому режимі. CTOP надає розробникам зручність моніторингу на кшталт htop, запобігаючи неконтрольованим циклам і неочікуваним рахункам за API.
TL;DR
- 01CTOP працює як аналог htop, створений спеціально для моніторингу сесій AI-агентів, таких як Claude Code, Codex CLI, OpenCode та Devin.
- 02Він показує в реальному часі діагностику в терміналі: процесор, пам'ять, токени, структуру контекстного вікна та витрати на API.
- 03Підтримує інтеграцію навички в Claude Code, завдяки чому агенти можуть самостійно запитувати телеметрію своєї активної сесії.
Ключові факти
- Підтримувані агенти
- Claude Code, Codex CLI, OpenCode, Devin
- Встановлення
- brew tap aakashadesara/ctop && brew install ctop-claude або через клонування з git
- Підтримка ОС
- macOS, Linux, Windows (PowerShell)
- Залежності
- sqlite3 (для OpenCode/Devin)
Термінальна панель для телеметрії AI-агентів
ctop вирішує проблему прозорості під час роботи з фоновими AI-агентами. Коли ви запускаєте кілька паралельних сесій Claude Code, Codex CLI, OpenCode чи Devin, важливо бачити обсяг контексту та поточні витрати на API. Інструмент зчитує інформацію про процеси через ps (або PowerShell у Windows) і зіставляє їх із локальними файлами метаданих та баз даних Claude (~/.claude/projects/), Codex (~/.codex/sessions/), OpenCode (~/.local/share/opencode/) або Devin (~/.local/share/devin/cli/).
Панель відображає візуальну діаграму контекстного вікна (вхідні, кешовані, вихідні та вільні токени) та оцінює вартість використання API для кожної сесії окремо або сумарно, допомагаючи уникнути непередбачених витрат через зациклення агентів.
Самоаналіз та рефлексія агентів
Ви можете встановити інтегровану навичку (skill) у Claude Code, щоб дозволити агенту самостійно запитувати свої метрики. Скопіюйте папку ctop у директорію навичок вашого проекту:
mkdir -p ~/.claude/skills && cp -r skills/ctop ~/.claude/skills/Після цього ви зможете запитати Claude Code: "скільки коштувала ця сесія?" або "чи скоро відбудеться стиснення контексту?". Агент виконуватиме команди на кшталт ctop whoami чи ctop stats, щоб проаналізувати свій стан і оптимізувати подальше використання токенів.
Керування сесіями та CLI-автоматизація
Інструмент підтримує режими списку та карток, трансляцію логів у реальному часі та керування процесами. Розробники можуть фільтрувати сесії за робочим каталогом або гілкою Git, закріплювати важливі процеси та завершувати завислі агенти через SIGTERM. Для автоматизації команда ctop ls --json повертає дані в JSON, що дозволяє створювати скрипти, які автоматично визначають критично низький рівень вільного контексту (наприклад, менше 15%) для виклику команди /compact.
Спробуй за 2 хвилини
brew tap aakashadesara/ctop && brew install ctop-claudebash
✓ Коли використовувати
- При запуску багатоагентних робочих процесів або тривалих фонових завдань, де необхідно контролювати витрату контексту та уникати неочікуваних рахунків за API.
✕ Коли НЕ варто
- Якщо ви не запускаєте локальних термінальних AI-агентів на кшталт Claude Code чи Codex CLI.
Що зробити сьогодні
- Встановіть CTOP за допомогою Homebrew: brew tap aakashadesara/ctop && brew install ctop-claude
- Інтегруйте навичку ctop у директорію проектів Claude Code для самоаналізу агента
Джерела