O que o Claudraband faz

O Claudraband é um wrapper para o TUI oficial do Claude Code que o executa em um ambiente de terminal controlado. Isso permite que desenvolvedores mantenham sessões persistentes do Claude Code, as retomem posteriormente, respondam a prompts pendentes, exponham sessões através de um daemon ou as conduzam através do Anthropic Client Protocol (ACP).

Recursos e Comandos Principais

A ferramenta oferece várias capacidades específicas:

• Fluxos de trabalho não interativos retomáveis: Essencialmente claude -p com suporte a sessões. Exemplo: cband continue <session-id> 'qual foi o resultado da pesquisa?'
• Daemon HTTP para controle remoto ou sem interface gráfica: Inicie com cband serve --host 127.0.0.1 --port 7842, então conecte com cband --connect localhost:7842 "iniciar um plano de migração"
• Servidor ACP para integração com editores e frontends alternativos: Execute cband acp --model opus ou cband acp --model haiku para habilitar integração com ferramentas como Toad ou Zed
• Biblioteca TypeScript para construir esses fluxos de trabalho em ferramentas personalizadas
• Gerenciamento de sessões: cband sessions lista sessões ativas rastreadas, cband sessions close --all fecha todas as sessões controladas

Configuração e Requisitos

Os requisitos incluem Node.js ou Bun, uma instalação do Claude Code já autenticada e tmux para fluxos de trabalho locais e baseados em daemon de primeira classe. Opções de instalação:

# uso pontual
npx @halfwhey/claudraband "revisar o diff em staging"

instalação global
npm install -g @halfwhey/claudraband

O pacote instala tanto claudraband quanto cband (abreviação recomendada). Ele inclui o Claude Code @anthropic-ai/[email protected] mas permite substituir com a variável de ambiente CLAUDRABAND_CLAUDE_PATH.

Exemplos de Fluxo de Trabalho

A fonte mostra vários casos de uso práticos:

• Sessões persistentes locais: cband "auditar o último commit e me dizer o que parece arriscado"
• Autointerrogação: O Claude pode interrogar uma sessão mais antiga do Claude e justificar as escolhas que fez
• Frontends alternativos: Toad ou Zed podem usar claudraband acp como um frontend alternativo para o Claude Code
• Integração de biblioteca: Exemplos em TypeScript incluem revisão de código, gerenciamento de múltiplas sessões e registro de sessões

Detalhes Técnicos

As sessões são rastreadas em ~/.claudraband/. O daemon usa por padrão o tmux como runtime de terminal. Uma opção experimental --backend xterm existe para fallback sem interface gráfica, mas é mais lenta que o tmux. O projeto é marcado como experimental e está evoluindo conforme o Claude Code e os clientes ACP mudam.

Advertência importante: Esta não é uma substituição para o SDK do Claude e é voltada para uso pessoal e ad-hoc. Não lida com OAuth ou contorna o TUI do Claude Code - cada interação passa por uma sessão real do Claude Code.