Qué hace Claudraband

Claudraband es un envoltorio para la TUI oficial de Claude Code que la ejecuta en un entorno de terminal controlado. Esto permite a los desarrolladores mantener sesiones persistentes de Claude Code, reanudarlas más tarde, responder a solicitudes pendientes, exponer sesiones a través de un demonio o manejarlas mediante el Protocolo de Cliente Anthropic (ACP).

Características y comandos principales

La herramienta proporciona varias capacidades específicas:

• Flujos de trabajo no interactivos reanudables: Esencialmente claude -p con soporte de sesión. Ejemplo: cband continue <session-id> '¿cuál fue el resultado de la investigación?'
• Demonio HTTP para control remoto o sin interfaz gráfica de sesiones: Iniciar con cband serve --host 127.0.0.1 --port 7842, luego conectar con cband --connect localhost:7842 "iniciar un plan de migración"
• Servidor ACP para integración con editores y frontends alternativos: Ejecutar cband acp --model opus o cband acp --model haiku para habilitar integración con herramientas como Toad o Zed
• Biblioteca TypeScript para construir estos flujos de trabajo en herramientas personalizadas
• Gestión de sesiones: cband sessions lista sesiones activas rastreadas, cband sessions close --all cierra todas las sesiones controladas

Configuración y requisitos

Los requisitos incluyen Node.js o Bun, una instalación de Claude Code ya autenticada y tmux para flujos de trabajo locales y respaldados por demonio de primera clase. Opciones de instalación:

# uso único
npx @halfwhey/claudraband "revisar el diff preparado"

instalar globalmente
npm install -g @halfwhey/claudraband

El paquete instala tanto claudraband como cband (abreviatura recomendada). Incluye Claude Code @anthropic-ai/[email protected] pero permite anularlo con la variable de entorno CLAUDRABAND_CLAUDE_PATH.

Ejemplos de flujos de trabajo

La fuente muestra varios casos de uso prácticos:

• Sesiones persistentes locales: cband "auditar el último commit y decirme qué parece riesgoso"
• Autointerrogación: Claude puede interrogar una sesión anterior de Claude y justificar las decisiones que tomó
• Frontends alternativos: Toad o Zed pueden usar claudraband acp como un frontend alternativo para Claude Code
• Integración de biblioteca: Los ejemplos de TypeScript incluyen revisión de código, gestión de múltiples sesiones y registro de sesiones

Detalles técnicos

Las sesiones se rastrean en ~/.claudraband/. El demonio utiliza por defecto tmux como entorno de terminal. Existe una opción experimental --backend xterm para respaldo sin interfaz gráfica pero es más lenta que tmux. El proyecto está marcado como experimental y evoluciona a medida que Claude Code y los clientes ACP cambian.

Advertencia importante: Esto no es un reemplazo del SDK de Claude y está orientado al uso personal y ad-hoc. No maneja OAuth ni evita la TUI de Claude Code - cada interacción se ejecuta a través de una sesión real de Claude Code.