@eximia-ventures/claude-code-toolkit 3.0.2 → 3.1.1

package/README.md

@@ -9,7 +9,7 @@
 
 <p align="center">
   <strong>Setup completo para Claude Code em um comando.</strong><br/>
-  Statusline customizada, session continuity e AIOS integration.
+  Statusline customizada, session continuity, usage monitor e AIOS integration.
 </p>
 
 <p align="center">
@@ -26,6 +26,7 @@ O `claude-code-toolkit` transforma sua experiência com o Claude Code instalando
 |---------|-----------|
 | **Statusline** | Barra de status em tempo real com modelo, contexto, custo, tempo e git |
 | **Session Handoff** | Continuidade de sessão entre `/clear` (7 slash commands, 2 hooks) |
+| **eximia-meter** | Monitor de consumo de tokens no menu bar do macOS |
 | **AIOS Framework** | Integração com orquestração de agentes AI (opt-in) |
 
 ---
@@ -87,8 +88,9 @@ O wizard guia você pelas opções:
   ╚══════════════════════════════════════╝
 
   ? Selecione o que deseja instalar:
-  ◉ Statusline      — Barra de status: modelo, contexto %, custo, tempo, git
-  ◉ Session Handoff — Continuidade de sessão (via claude-code-handoff)
+  ○ Statusline      — Barra de status: modelo, contexto %, custo, tempo, git
+  ○ Session Handoff — Continuidade de sessão (via claude-code-handoff)
+  ○ eximia-meter    — Monitor de consumo de tokens (menu bar macOS)
 
   ─── Configuração da Statusline ───
 
@@ -107,22 +109,10 @@ O wizard guia você pelas opções:
   ✓ Statusline instalada em ~/.claude/statusline.sh
   ✓ settings.json atualizado com statusLine
   ✓ claude-code-handoff instalado (7 commands, 2 hooks, 2 rules)
+  ✓ eximia-meter instalado
   ✓ Pronto!
 ```
 
-### Instalacao direta (sem wizard)
-
-```bash
-# Statusline com BRL
-npx @eximia-ventures/claude-code-toolkit install --statusline-only --currency 'R$' --currency-rate 6.20
-
-# Apenas session handoff
-npx @eximia-ventures/claude-code-toolkit install --handoff-only
-
-# Tudo exceto AIOS
-npx @eximia-ventures/claude-code-toolkit install --no-aios
-```
-
 ---
 
 ## Fluxo de Instalacao
@@ -134,6 +124,7 @@ flowchart TD
     B --> C["Selecionar módulos"]
     C --> D{Statusline?}
     C --> E{Handoff?}
+    C --> M{eximia-meter?}
     C --> F{AIOS?}
 
     D -->|Sim| D1["Escolher moeda\nBRL / USD / EUR / Custom"]
@@ -142,12 +133,16 @@ flowchart TD
     E -->|Sim| E1["npx claude-code-handoff"]
     E1 --> E2["7 commands + 2 hooks + 2 rules\n.claude/handoffs/"]
 
+    M -->|Sim| M1["npx eximia-meter"]
+    M1 --> M2["App no menu bar\nMonitor de tokens"]
+
     F -->|Sim| F1{Sub-opções}
     F1 --> F2["AIOS Core\nnpx aios-core install"]
     F1 --> F3["Skill /aios-integrate\n.claude/commands/"]
 
     D2 --> G["Salva manifest\n.toolkit-manifest.json"]
     E2 --> G
+    M2 --> G
     F2 --> G
     F3 --> G
 
@@ -157,6 +152,7 @@ flowchart TD
     style H fill:#22c55e,color:#fff,stroke:none
     style D1 fill:#f59e0b,color:#000,stroke:none
     style E1 fill:#3b82f6,color:#fff,stroke:none
+    style M1 fill:#22c55e,color:#fff,stroke:none
     style F2 fill:#8b5cf6,color:#fff,stroke:none
     style F3 fill:#8b5cf6,color:#fff,stroke:none
 ```
@@ -168,16 +164,10 @@ flowchart TD
 ### `install` (default)
 
 ```bash
-npx @eximia-ventures/claude-code-toolkit [install] [options]
+npx @eximia-ventures/claude-code-toolkit
 ```
 
-| Flag | Descrição |
-|------|-----------|
-| `--statusline-only` | Instala apenas a statusline |
-| `--handoff-only` | Instala apenas o session handoff |
-| `--no-aios` | Pula a configuração do AIOS |
-| `--currency <symbol>` | Símbolo da moeda (`R$`, `$`, `€`) |
-| `--currency-rate <rate>` | Taxa de conversão USD → moeda |
+Abre o wizard interativo onde você seleciona os módulos desejados. Todas as opções começam desmarcadas.
 
 ### `doctor`
 
@@ -241,7 +231,24 @@ Instala o pacote [`claude-code-handoff`](https://www.npmjs.com/package/claude-co
 | Rules | `session-continuity.md`, `auto-handoff.md` |
 | Estrutura | `.claude/handoffs/` |
 
-### 3. AIOS Framework (opt-in)
+### 3. eximia-meter
+
+Monitor de consumo de tokens que vive no menu bar do macOS. Instala via [`eximia-meter`](https://github.com/eximIA-Ventures/eximia-meter).
+
+**O que mostra:**
+
+| Metrica | Descrição |
+|---------|-----------|
+| Consumo semanal | Progresso do limite com barra visual |
+| Burn rate | Projeção de consumo e countdown para reset |
+| Por projeto | Tokens e custo por projeto |
+| Distribuição | Breakdown por modelo (Opus/Sonnet/Haiku) |
+| Heatmap 24h | Atividade por hora com níveis de intensidade |
+| Custo estimado | USD ponderado por modelo |
+
+**Complementa a statusline:** a statusline mostra dados da sessão atual, o meter mostra a visão macro semanal/por projeto.
+
+### 4. AIOS Framework (opt-in)
 
 Para quem usa o [Synkra AIOS](https://github.com/eximIA-Ventures) — framework de orquestração de agentes AI.
 
@@ -285,6 +292,7 @@ claude-code-toolkit/
 │   │   ├── index.js                  # Registry dos módulos
 │   │   ├── statusline.js             # ~/.claude/statusline.sh + settings.json
 │   │   ├── handoff.js                # npx claude-code-handoff
+│   │   ├── meter.js                  # npx eximia-meter
 │   │   └── aios.js                   # npx aios-core + skill
 │   ├── commands/
 │   │   ├── uninstall.js              # Remoção via manifest
@@ -313,10 +321,11 @@ sequenceDiagram
     participant CC as Claude Code
 
     U->>T: npx @eximia-ventures/claude-code-toolkit
-    T->>T: Wizard interativo
-    T->>SH: Copia statusline.sh
+    T->>T: Wizard interativo (tudo desmarcado)
+    T->>SH: Copia statusline.sh (se selecionado)
     T->>S: Deep-merge statusLine config
-    T->>T: npx claude-code-handoff
+    T->>T: npx claude-code-handoff (se selecionado)
+    T->>T: npx eximia-meter (se selecionado)
     T->>T: Salva manifest
 
     Note over U,CC: Após reiniciar o Claude Code
@@ -376,7 +385,7 @@ Ou rode o toolkit novamente — ele sobrescreve com a nova config.
 <details>
 <summary><strong>Posso instalar só a statusline sem o handoff?</strong></summary>
 
-Sim: `npx @eximia-ventures/claude-code-toolkit install --statusline-only`
+Sim — no wizard, marque apenas a opção "Statusline" e avance.
 </details>
 
 <details>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eximia-ventures/claude-code-toolkit",
-  "version": "3.0.2",
+  "version": "3.1.1",
   "description": "Setup completo para Claude Code: statusline, session handoff, AIOS integration",
   "main": "src/index.js",
   "bin": {

package/src/installer.js

@@ -37,6 +37,11 @@ async function runInstaller() {
           name: `${modules.handoff.name} — ${modules.handoff.description}`,
           value: 'handoff',
           checked: false
+        },
+        {
+          name: `${modules.meter.name}    — ${modules.meter.description}`,
+          value: 'meter',
+          checked: false
         }
       ]
     }
@@ -154,6 +159,14 @@ async function runInstaller() {
     }
   }
 
+  // Install meter
+  if (selectedModules.includes('meter')) {
+    const result = await modules.meter.module.install();
+    if (result.installed) {
+      manifest.files.push(...modules.meter.module.getManifestEntries());
+    }
+  }
+
   // Install AIOS
   if (selectedModules.includes('aios')) {
     const result = await modules.aios.module.install(aiosOptions);

package/src/modules/index.js

@@ -2,6 +2,7 @@
 
 const statusline = require('./statusline');
 const handoff = require('./handoff');
+const meter = require('./meter');
 const aios = require('./aios');
 
 const modules = {
@@ -9,13 +10,19 @@ const modules = {
     name: 'Statusline',
     description: 'Barra de status: modelo, contexto %, custo, tempo, git',
     module: statusline,
-    default: true
+    default: false
   },
   handoff: {
     name: 'Session Handoff',
     description: 'Continuidade de sessão (via claude-code-handoff)',
     module: handoff,
-    default: true
+    default: false
+  },
+  meter: {
+    name: 'eximia-meter',
+    description: 'Monitor de consumo de tokens (menu bar macOS)',
+    module: meter,
+    default: false
   },
   aios: {
     name: 'AIOS Framework',

package/src/modules/meter.js

@@ -0,0 +1,33 @@
+'use strict';
+
+const { execSync } = require('child_process');
+const logger = require('../utils/logger');
+
+async function install() {
+  logger.section('eximia-meter');
+
+  try {
+    logger.dim('Executando eximia-meter...');
+    execSync('npx eximia-meter@latest', {
+      stdio: 'inherit',
+      timeout: 180000
+    });
+    logger.success('eximia-meter instalado');
+    return { installed: true };
+  } catch (err) {
+    logger.warn(`eximia-meter falhou: ${err.message}`);
+    logger.dim('Você pode instalar manualmente depois: npx eximia-meter');
+    return { installed: false, error: err.message };
+  }
+}
+
+async function uninstall() {
+  logger.dim('eximia-meter é um app standalone — remova manualmente se necessário.');
+  return [];
+}
+
+function getManifestEntries() {
+  return ['eximia-meter'];
+}
+
+module.exports = { install, uninstall, getManifestEntries };