Iccmonit — Communication skill for Claude Code

iccmonit — INEMA Claude Monitor

TUI em Python que monitora **todas as sessões Claude Code ativas** na máquina em tempo real, com cota 5h/7d, métricas por sessão e chat embutido via OAuth.

Pensado para rodar em um **terminal separado** ao lado das suas sessões Claude Code, dando visão consolidada de:

• Sessões ativas (busy / idle), modelo em uso, % do contexto consumido
• Cota da API: janela de 5 horas, semanal global e semanal Sonnet (separada)
• Tamanho do CLAUDE.md, da memória do projeto, agentes lançados e skills invocadas
• Chat com Claude (Haiku por padrão) ciente do estado do painel

Versão atual: **v1.17.11**


---

Sumário

• Requisitos
• Instalação
• Uso
  • Modo terminal
  • Modo web
  • Atalhos
• Painéis da TUI
• Fontes de dados
• Configuração
• Arquitetura
• Versionamento
• Roadmap
• Solução de problemas
• Por que não usar X?
• Licença

---

Requisitos

• Python 3.10+
• Claude Code instalado e logado (precisa de ~/.claude/.credentials.json válido)
• Statusline padrão do Claude Code rodando — é ele que popula /tmp/cc_limits_.json com a cota oficial da API. Sem isso o painel de cota fica vazio.
• Sistema operacional Linux ou macOS (testado no Linux). O tac é usado para ler transcripts de trás pra frente — em macOS tem o equivalente.

Instalação

git clone git@github.com:inematds/iccmonit.git
cd iccmonit
chmod +x start.sh

Dependências (instaladas automaticamente pelo `start.sh` se faltarem):

pip install textual anthropic --break-system-packages           # modo terminal
pip install textual-serve --break-system-packages               # modo w