@eximia-ventures/claude-code-toolkit

v5.3.0

Published

7 days ago

Setup completo para Claude Code: statusline, session handoff, AIOS integration

0High
0Medium
0Low

eximia-ventures

claude claude-code statusline toolkit aios developer-tools

O que faz?

O claude-code-toolkit transforma sua experiência com o Claude Code instalando automaticamente:

| Recurso | Descrição | |---------|-----------| | 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 | 7 slash commands com wizards interativos: story, epic, QA, publish, bootstrap, help, integrate (opt-in) | | Squad Forge | Transforma squads e agents em plataformas visuais interativas (Chat, Canvas, Wizard, Dashboard) | | Pacotes externos | Instala pacotes complementares via npm install (ex: @eximia-ventures/ds) |

Statusline

Após instalar, sua barra de status no Claude Code fica assim:

🟣 Opus 4.6 | 📅 16/02/2026 | 📊 4K | ⚡ 3 | ████░░░░░░ 42% | 💰 R$0.31 | ⏱ 1m05s | 🔀 main

Segmentos

| Segmento | Dados | Exemplo | |----------|-------|---------| | Modelo | model.id | 🟣 Opus 4.6, 🔵 Sonnet 4.5, 🔵 Haiku 4.5 | | Data | Sistema | 📅 16/02/2026 | | Contexto | context_window.total_*_tokens | 📊 4K, 📊 120K, 📊 1.2M | | Mensagens | Transcript JSONL | ⚡ 3 | | Progresso | context_window.used_percentage | ████░░░░░░ 42% | | Custo | cost.total_cost_usd × taxa | 💰 R$0.31, 💰 $0.05, 💰 €0.05 | | Tempo | cost.total_duration_ms | ⏱ 1m05s, ⏱ 32s | | Git | git branch (cache 5s) | 🔀 main, 🔀 feat/login |

Cores da barra de progresso

██████████ 100%   🔴 Vermelho (>80%)
██████░░░░  60%   🟡 Amarelo  (60-80%)
████░░░░░░  40%   🟢 Verde    (<60%)

Moeda configurável

A moeda do custo é definida no wizard e pode ser alterada via variáveis de ambiente:

export CLAUDE_TOOLKIT_CURRENCY="R$"       # Símbolo
export CLAUDE_TOOLKIT_CURRENCY_RATE="6.20" # Taxa USD → moeda

Instalacao

Wizard interativo (recomendado)

npx @eximia-ventures/claude-code-toolkit

O wizard guia você pelas opções:

  ╔══════════════════════════════════════╗
  ║   claude-code-toolkit v5.1.0        ║
  ║   Setup completo para Claude Code   ║
  ╚══════════════════════════════════════╝

  ? Selecione o que deseja instalar:
  ○ 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 ───

  ? Moeda para exibição de custo:
  > BRL (R$)  — Taxa: 6.20
    USD ($)   — Sem conversão
    EUR (€)   — Taxa: 0.92
    Personalizada — Definir símbolo e taxa

  ─── AIOS Framework ───

  ? Vai utilizar o AIOS? (s/N)

  ? Selecione os componentes AIOS:
  ◉ AIOS Core          — Framework base (npx aios-core install)
  ◉ /aios-integrate    — Gerenciar artefatos (agents/squads)
  ◉ /aios-story        — Operações de story (criar, validar, desenvolver, QA)
  ◉ /aios-epic         — Gestão de epics (criar, executar, status)
  ◉ /aios-qa           — QA toolkit (scan, gate, loop, testes, security)
  ◉ /aios-publish      — Release management (version, changelog, publish)
  ◉ /aios-bootstrap    — Setup de projeto (greenfield, brownfield, team, GitHub)
  ◉ /aios-help         — Guia de comandos AIOS (reference, busca, workflows)

  ─── Instalando... ───

  ✓ Statusline instalada em ~/.claude/statusline.sh
  ✓ settings.json atualizado com statusLine
  ✓ claude-code-handoff instalado (7 commands, 2 hooks, 2 rules)
  ✓ eximia-meter instalado
  ✓ AIOS Core instalado/atualizado
  ✓ 7 Skills AIOS instaladas
  ✓ Pronto!

Fluxo de Instalacao

flowchart TD
    A["npx @eximia-ventures/claude-code-toolkit"] --> B{Wizard interativo}

    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"]
    D1 --> D2["Instala ~/.claude/statusline.sh\nMerge settings.json"]

    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["7 Skills AIOS\n.claude/commands/"]

    F3 --> F4["integrate · story · epic\nqa · publish · bootstrap · help"]

    D2 --> G["Salva manifest\n.toolkit-manifest.json"]
    E2 --> G
    M2 --> G
    F2 --> G
    F4 --> G

    G --> H["✓ Pronto!\nReinicie o Claude Code"]

    style A fill:#5B4FE5,color:#fff,stroke:none
    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
    style F4 fill:#8b5cf6,color:#fff,stroke:none

Comandos

`install` (default)

npx @eximia-ventures/claude-code-toolkit

Abre o wizard interativo onde você seleciona os módulos desejados. Todas as opções começam desmarcadas.

`doctor`

Verifica a integridade da instalação com 10 checks:

npx @eximia-ventures/claude-code-toolkit doctor

  ─── Diagnóstico ───

  ✓ Manifest encontrado (v5.1.0)
  ✓ Diretório ~/.claude/ existe
  ✓ settings.json contém statusLine
  ✓ statusline.sh existe e é executável
  ✓ jq instalado (jq-1.7.1)
  ✓ git version 2.50.1
  ✓ Node.js v25.6.0
  ✓ Handoff commands encontrados (7 de 7)
  ✓ AIOS Core instalado no projeto
  ✓ 7 Skills AIOS instaladas (integrate, story, epic, qa, publish, bootstrap, help)

  ✓ Tudo OK! (10 verificações passaram)

`update [module]`

Atualiza os módulos já instalados sem passar pelo wizard. Lê o manifest, re-executa a instalação de cada módulo e usa hash comparison para pular arquivos que já estão em dia.

# Atualizar tudo
npx @eximia-ventures/claude-code-toolkit update

# Atualizar apenas um módulo
npx @eximia-ventures/claude-code-toolkit update aios
npx @eximia-ventures/claude-code-toolkit update statusline
npx @eximia-ventures/claude-code-toolkit update handoff
npx @eximia-ventures/claude-code-toolkit update meter

  ─── Atualização ───

  ℹ Instalação encontrada (v5.1.0, 4 módulos)

  ─── Statusline ───

  ✓ Statusline já atualizada em ~/.claude/statusline.sh
  ✓ settings.json atualizado com statusLine

  ─── Session Handoff ───

  ✓ claude-code-handoff instalado (7 commands, 2 hooks, 2 rules)

  ─── AIOS Framework ───

  ✓ 7 Skills AIOS atualizadas (integrate, story, epic, qa, publish, bootstrap, help)

  ✓ Atualização completa (4 atualizado(s), 0 já em dia)

`uninstall`

Remove tudo que foi instalado, baseado no manifest:

npx @eximia-ventures/claude-code-toolkit uninstall [--force]

Modulos

1. Statusline

A feature principal. Instala um script bash em ~/.claude/statusline.sh que recebe JSON do Claude Code via stdin e renderiza a barra de status.

Arquivos tocados:

| Arquivo | Ação | |---------|------| | ~/.claude/statusline.sh | Criado (bash + jq) | | ~/.claude/settings.json | Merge com statusLine.command | | ~/.claude/toolkit-env.sh | Criado (variáveis de moeda) |

Requisito: jq instalado (brew install jq)

2. Session Handoff

Instala o pacote claude-code-handoff no projeto, que adiciona:

| Tipo | Itens | |------|-------| | Slash Commands | /resume, /handoff, /save-handoff, /switch-context, /delete-handoff, /auto-handoff, /context-doctor | | Hooks | context-monitor.sh, session-cleanup.sh | | Rules | session-continuity.md, auto-handoff.md | | Estrutura | .claude/handoffs/ |

3. eximia-meter

Monitor de consumo de tokens que vive no menu bar do macOS. Instala via 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 — framework de orquestração de agentes AI.

AIOS Core — Instala/atualiza o framework via npx aios-core install

7 Skills AIOS — Slash commands com wizards interativos para o Claude Code:

| Skill | Descrição | |-------|-----------| | /aios-integrate | Gerenciar artefatos (agents/squads) — importar, listar, exportar | | /aios-story | Operações de story (criar, validar, desenvolver, QA gate) | | /aios-epic | Gestão de epics (criar, executar, acompanhar status) | | /aios-qa | QA toolkit (scan, gate, loop, testes, security audit) | | /aios-publish | Release management (version bump, changelog, publish) | | /aios-bootstrap | Setup de projeto (greenfield, brownfield, team config, GitHub) | | /aios-help | Guia de comandos AIOS (reference, busca, workflows) |

flowchart LR
    A["AIOS Skills"] --> B["/aios-story\n/aios-epic"]
    A --> C["/aios-qa\n/aios-publish"]
    A --> D["/aios-bootstrap\n/aios-integrate"]
    A --> E["/aios-help"]

    B --> F["Criar, validar,\ndesenvolver stories\ne epics"]
    C --> G["QA gate, loop,\nrelease management"]
    D --> H["Setup de projeto,\ngerenciar artefatos"]
    E --> I["Referência completa\nde comandos AIOS"]

    style A fill:#5B4FE5,color:#fff,stroke:none
    style F fill:#f59e0b,color:#000,stroke:none
    style G fill:#3b82f6,color:#fff,stroke:none
    style H fill:#22c55e,color:#fff,stroke:none
    style I fill:#8b5cf6,color:#fff,stroke:none

Squad Arsenal

Squad Forge 🔥

"Making the invisible visible" — transforma qualquer squad, agent ou clone em uma plataforma visual interativa.

O Platform Forge é um squad que materializa agents em produtos reais. Em vez de interagir via CLI, os usuários finais ganham uma interface web polida.

Agents

| Agent | Persona | Papel | |-------|---------|-------| | @bret-victor 🔥 | Bret Victor (Inventing on Principle) | Orquestrador — detecta padrão de UI, dirige o pipeline completo | | @kinneret ✍️ | Kinneret Yifrah + Torrey Podmajersky | Voice Architect — microcopy, Voice Chart, narrativa da plataforma | | @wes-bush 🚀 | Wes Bush + Tod Golding + Sangeet Paul Choudary | Growth Architect — PLG, onboarding, multi-tenant, platform strategy |

Padrões de UI detectáveis

O Forge classifica automaticamente o squad em um dos 4 padrões visuais:

| Padrão | Ideal para | Stack | |--------|-----------|-------| | Chat | Squads onde usuários falam com agents | Next.js + Vercel AI SDK + Shadcn Chat | | Canvas | Squads onde usuários constroem passo a passo | Next.js + React DnD/Konva + Shadcn | | Wizard | Squads com assessments, diagnósticos, scoring | Next.js + React Hook Form + Zod + Shadcn | | Dashboard | Squads com métricas, analytics, monitoring | Next.js + Tremor/Recharts + TanStack Table + Shadcn |

Pipeline wf-forge (9 fases)

flowchart TD
    START(["@bret-victor *forge {squad}"]) --> P0

    P0["Phase 0\nQuick Wizard\n@bret-victor"]
    P0 --> P1

    P1["Phase 1\nAnalysis\n@bret-victor"]
    P1 --> PAT{Padrão\ndetectado}
    PAT --> CHAT["Chat\nVercel AI SDK"]
    PAT --> CANVAS["Canvas\nReact DnD"]
    PAT --> WIZARD["Wizard\nRHF + Zod"]
    PAT --> DASH["Dashboard\nTremor"]

    CHAT & CANVAS & WIZARD & DASH --> P2

    P2["Phase 2\nStrategy\n@wes-bush"]
    P2 --> P3["Phase 3\nDesign System\n@design-system"]
    P3 --> P4["Phase 4\nUX Writing\n@kinneret"]
    P4 --> P5["Phase 5\nSpec\n@pm + @architect"]
    P5 --> P6["Phase 6\nBuild\n@dev"]
    P6 --> P7["Phase 7\nQA\n@qa"]
    P7 --> P8["Phase 8\nDeploy\n@devops"]
    P8 --> END(["✓ Plataforma publicada"])

    style START fill:#F56000,color:#fff,stroke:none
    style END fill:#22c55e,color:#fff,stroke:none
    style P0 fill:#F56000,color:#fff,stroke:none
    style P1 fill:#F56000,color:#fff,stroke:none
    style P2 fill:#3b82f6,color:#fff,stroke:none
    style P3 fill:#8b5cf6,color:#fff,stroke:none
    style P4 fill:#ec4899,color:#fff,stroke:none
    style P5 fill:#5B4FE5,color:#fff,stroke:none
    style P6 fill:#22c55e,color:#fff,stroke:none
    style P7 fill:#f59e0b,color:#000,stroke:none
    style P8 fill:#14b8a6,color:#fff,stroke:none
    style PAT fill:#1e293b,color:#fff,stroke:none
    style CHAT fill:#0ea5e9,color:#fff,stroke:none
    style CANVAS fill:#a855f7,color:#fff,stroke:none
    style WIZARD fill:#f97316,color:#fff,stroke:none
    style DASH fill:#10b981,color:#fff,stroke:none

Slash commands

| Comando | Descrição | |---------|-----------| | /forge {squad} | Pipeline completo — Phases 0 a 8 | | /forge-diagnose {squad} | Diagnóstico de padrão UI sem build (Phase 1) | | /forge-map-capabilities {squad} | Mapeia capabilities do squad → features de produto | | /forge-diagnose-squad {squad} | Executa task de diagnóstico diretamente |

Como usar

# Forjar um squad em plataforma visual completa
/forge aios-master

# Apenas diagnosticar o padrão de UI (sem build)
/forge-diagnose biblical

# Via agent diretamente
@bret-victor *forge {squad}
@bret-victor *diagnose {squad}
@bret-victor *patterns
@bret-victor *wizard {squad}
@bret-victor *spec {squad}

# Agents especializados
@kinneret *voice-chart {platform}
@kinneret *microcopy {platform}
@wes-bush *platform-canvas {squad}
@wes-bush *bowling-alley {squad}
@wes-bush *tenant-model {squad}

Output gerado

forge/{target}/
├── wizard-config.yaml       # Phase 0 — personalização
├── analysis.md              # Phase 1 — padrão + capability map
├── strategy.md              # Phase 2 — PLG + onboarding + tenant model
├── design/
│   ├── tokens.yaml          # Phase 3 — design tokens
│   └── component-inventory.md
├── microcopy.md             # Phase 4 — voice chart + todos os textos
├── spec/
│   ├── prd.md               # Phase 5 — product requirements
│   ├── tech-spec.md         # Phase 5 — arquitetura técnica
│   └── api-design.md        # Phase 5 — contratos de API
├── qa-report.md             # Phase 7 — relatório de QA
└── deployment.md            # Phase 8 — guia de deploy

Design System Manager (`@eximia-ventures/ds`) 📦

Pacote npm independente que gerencia design systems como artefatos instaláveis (formato .dspack). O toolkit oferece sua instalação via wizard — as skills são instaladas pelo próprio pacote.

npm install @eximia-ventures/ds

Formato .dspack — zip padronizado compatível com W3C DTCG:

meu-ds.dspack
├── manifest.json         # nome, versão, inventário, formato DTCG
├── tokens/
│   ├── tokens.json       # W3C DTCG format
│   ├── tokens.css        # CSS custom properties
│   └── tokens.tw.js      # Tailwind config
└── components/
    ├── atoms/
    ├── molecules/
    ├── organisms/
    └── templates/

Skills instaladas pelo pacote: /ds, /ds-pack, /ds-install, /ds-list, /ds-apply

Fluxo com Forge:

flowchart LR
    PACK["meu-ds.dspack"] --> INSTALL["/ds-install"]
    INSTALL --> MANIFEST["design-systems/\nmanifest.json"]
    MANIFEST --> FORGE["@bret-victor *forge {squad}\nPhase 0: detecta DS instalado"]
    FORGE --> P3["Phase 3: Brad Frost\nreutiliza tokens do DS"]
    P3 --> OUT["forge/{target}/design/\ntokens + components + tema"]

    style PACK fill:#f59e0b,color:#000,stroke:none
    style INSTALL fill:#5B4FE5,color:#fff,stroke:none
    style MANIFEST fill:#1e293b,color:#fff,stroke:none
    style FORGE fill:#F56000,color:#fff,stroke:none
    style P3 fill:#8b5cf6,color:#fff,stroke:none
    style OUT fill:#22c55e,color:#fff,stroke:none

Integrar novos squads via inbox

Squads externos podem ser integrados via /aios-integrate ou pelo sistema de inbox:

# Coloque o squad em:
.aios-core/inbox/{squad-name}/
  ├── squad.yaml      # Manifest AIOS obrigatório
  ├── agents/         # Definições de agents
  ├── tasks/          # Tasks executáveis
  └── workflows/      # Workflows

# Depois execute /aios-integrate — o inbox é detectado automaticamente

flowchart LR
    ZIP["squad-export.zip"] --> INBOX[".aios-core/inbox/{squad}/"]
    INBOX --> DETECT{"/aios-integrate\ndetecta inbox"}
    DETECT --> VAL["Validação\nschema + IDs"]
    VAL -->|PASS| COPY["squads/{name}/\n+ .codex/agents/\n+ .antigravity/\n+ .agent/workflows/"]
    VAL -->|FAIL| ERR["Erro reportado\n+ sugestão de fix"]
    COPY --> CSV[".aios-core/manifests/agents.csv\natualizado"]
    COPY --> CMD[".claude/commands/\n{prefix}-*.md criados"]
    COPY --> PROC[".aios-core/inbox/.processed/\nartefato arquivado"]

    style ZIP fill:#f59e0b,color:#000,stroke:none
    style DETECT fill:#5B4FE5,color:#fff,stroke:none
    style VAL fill:#1e293b,color:#fff,stroke:none
    style COPY fill:#22c55e,color:#fff,stroke:none
    style ERR fill:#ef4444,color:#fff,stroke:none
    style CSV fill:#3b82f6,color:#fff,stroke:none
    style CMD fill:#8b5cf6,color:#fff,stroke:none
    style PROC fill:#64748b,color:#fff,stroke:none

Arquitetura

claude-code-toolkit/
├── package.json
├── bin/
│   └── cli.js                        # Entry point
├── src/
│   ├── index.js                      # CLI (Commander.js)
│   ├── installer.js                  # Wizard interativo (Inquirer)
│   ├── modules/
│   │   ├── 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 + skills
│   ├── commands/
│   │   ├── uninstall.js              # Remoção via manifest
│   │   ├── update.js                 # Atualização sem wizard
│   │   └── doctor.js                 # 10 checks de integridade
│   └── utils/
│       ├── settings-merger.js        # Deep-merge seguro (com backup)
│       ├── file-installer.js         # Cópia com hash comparison
│       └── logger.js                 # Output estilizado (Chalk)
├── assets/
│   ├── statusline/
│   │   └── statusline.sh             # Script bash (jq + ANSI)
│   └── skill/
│       ├── aios-integrate.md         # Gerenciar artefatos (agents/squads)
│       ├── aios-story.md             # Operações de story
│       ├── aios-epic.md              # Gestão de epics
│       ├── aios-qa.md                # QA toolkit
│       ├── aios-publish.md           # Release management
│       ├── aios-bootstrap.md         # Setup de projeto
│       └── aios-help.md              # Guia de comandos AIOS
└── squads/
    └── forge/                        # Squad Forge (Platform Materializer)
        ├── squad.yaml                # Manifest AIOS
        ├── agents/
        │   ├── bret-victor.md        # Forge Orchestrator
        │   ├── kinneret.md           # Platform Voice Architect
        │   └── wes-bush.md           # Platform Growth Architect
        ├── tasks/
        │   ├── diagnose-squad.md     # Detecta padrão de UI
        │   └── map-capabilities.md   # Capability → Feature mapping
        ├── workflows/
        │   └── wf-forge.yaml         # Pipeline completo (9 fases)
        ├── checklists/
        ├── templates/
        └── data/
            ├── pattern-signatures.yaml
            └── stack-recommendations.yaml

Como funciona

sequenceDiagram
    participant U as Usuário
    participant T as Toolkit CLI
    participant S as ~/.claude/settings.json
    participant SH as ~/.claude/statusline.sh
    participant CC as Claude Code

    U->>T: npx @eximia-ventures/claude-code-toolkit
    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 (se selecionado)
    T->>T: npx eximia-meter (se selecionado)
    T->>T: Salva manifest

    Note over U,CC: Após reiniciar o Claude Code

    CC->>S: Lê settings.json
    CC->>SH: Executa statusline.sh (JSON via stdin)
    SH->>SH: Parseia com jq
    SH->>CC: Retorna string formatada
    CC->>U: Exibe barra de status

Seguranca

Backup automático: settings.json é salvo como .backup antes de qualquer merge
Deep-merge seguro: Nunca sobrescreve configurações existentes, apenas adiciona/atualiza
Hash comparison: Arquivos só são sobrescritos se o conteúdo mudou
Manifest: Tudo que é instalado fica registrado em .toolkit-manifest.json para uninstall preciso
Idempotente: Rodar o install múltiplas vezes é seguro

Requisitos

| Dependência | Versão | Necessário para | |-------------|--------|-----------------| | Node.js | >= 18 | CLI | | jq | qualquer | Statusline | | git | qualquer | Segmento git da statusline |

FAQ

Reinicie o Claude Code completamente (feche e abra)
Rode npx @eximia-ventures/claude-code-toolkit doctor para verificar
Confira se jq está instalado: jq --version

Adicione ao seu ~/.zshrc ou ~/.bashrc:

export CLAUDE_TOOLKIT_CURRENCY="€"
export CLAUDE_TOOLKIT_CURRENCY_RATE="0.92"

Ou rode o toolkit novamente — ele sobrescreve com a nova config.

Sim — no wizard, marque apenas a opção "Statusline" e avance.

O backup fica em ~/.claude/settings.json.backup. Restaure com:

cp ~/.claude/settings.json.backup ~/.claude/settings.json

npx @eximia-ventures/claude-code-toolkit uninstall

Isso lê o manifest e remove apenas o que foi instalado pelo toolkit.

Use o sistema de inbox do AIOS:

Coloque o squad em .aios-core/inbox/{squad-name}/ com um squad.yaml
Execute /aios-integrate — o inbox é detectado automaticamente
Confirme a integração — o squad vai para squads/{squad-name}/ e os slash commands são criados

Alternativamente, use /aios-integrate → opção 1 (Integrar artefato externo) e informe o caminho.

O Squad Forge transforma qualquer squad ou agent em uma plataforma web interativa. Use quando quiser que usuários finais sem acesso ao Claude Code possam interagir com seus agents via interface visual.

Exemplo: /forge aios-master → gera um app completo onde usuários gerenciam stories e epics via UI.

Dependencias

| Pacote | Versão | Motivo | |--------|--------|--------| | commander | ^12.1.0 | CLI framework | | inquirer | ^8.2.6 | Wizard interativo (CommonJS) | | chalk | ^4.1.2 | Output colorido (CommonJS) | | fs-extra | ^11.3.0 | File operations | | claude-code-handoff | ^2.1.0 | Session continuity |

Nota: inquirer@8 e chalk@4 são versões CommonJS — evita problemas de ESM com npx.

License

MIT