AI:Claude Code All-in-One Monitor

Z wikiMedic

CC AIO MON (Claude Code All-in-One Monitor)

CC AIO MON je open-source terminálový monitor (TUI) určený pro sledování metrik, nákladů a limitů při práci s nástrojem Claude Code CLI od společnosti Anthropic. Autorem projektu je Pavol Pagáčik.

Nástroj vznikl jako reakce na chybějící nativní přehled o čerpání kontextového okna, nákladech na relaci a blížících se limitech API přímo během práce v terminálu.

Hlavní funkce

Monitor běží v reálném čase vedle Claude Code a poskytuje následující metriky:

  • Využití kontextového okna: Zobrazení zbývajícího počtu tokenů.
  • API Rate Limity: Sledování limitů v intervalech 5 hodin a 7 dní s varovným systémem před zablokováním.
  • Burn Rate: Aktuální finanční náklady v USD za minutu.
  • Cache Hit Rate: Indikace efektivity využívání prompt cachingu.
  • Agregace nákladů: Přehled o ceně aktuální session i historické souhrny (dnes / posledních 7 dní).

Technická specifikace

Projekt klade důraz na minimalismus a bezpečnost:

  • Jazyk: Python 3.8+
  • Závislosti: Žádné externí knihovny (pouze standardní knihovna Pythonu – stdlib).
  • Rozsah: Cca 1700 řádků kódu a 142 testů.
  • Kompatibilita: CI testování probíhá na systémech Ubuntu a Windows.
  • Bezpečnost: Kód prošel nezávislým review pomocí modelů Gemini Pro, Grok a Claude Opus.

Porovnání s alternativami

Funkce cc-aio-mon claude-monitor ccusage ccstatusline
Reálný čas Ano Ne Ne Ano
Metoda sběru Oficiální JSON Scrape logů - -
Rozhraní TUI + statusline Bez TUI Bez TUI Pouze statusline
Závislosti Pouze stdlib - - -
Multi-session Ano Ne - Ne

Instalace a nastavení

Setup nevyžaduje pip install ani build krok.

  1. Klonování repozitáře:
git clone https://github.com/iM3SK/cc-aio-mon.git ~/.cc-aio-mon
  1. Konfigurace Claude Code:
Do souboru ~/.claude/settings.json přidejte:
{"statusLine":{"type":"command","command":"bash -c 'python3 ~/.cc-aio-mon/statusline.py'"}}
  1. Spuštění monitoru:
python3 ~/.cc-aio-mon/monitor.py

Komunita a vývoj

Projekt je aktuálně ve fázi testování. Autor hledá testery zejména pro platformy macOS (Terminal.app, iTerm2) a Linux. Chyby (bugy) lze hlásit přes GitHub Issues.

Externí odkazy