Ce que fait Claudraband

Claudraband est un enveloppeur pour l'interface TUI officielle de Claude Code qui l'exécute dans un environnement de terminal contrôlé. Cela permet aux développeurs de maintenir des sessions Claude Code persistantes, de les reprendre plus tard, de répondre aux invites en attente, d'exposer les sessions via un démon, ou de les piloter via le protocole client Anthropic (ACP).

Fonctionnalités et commandes clés

L'outil offre plusieurs capacités spécifiques :

• Flux de travail non interactifs reprises : Essentiellement claude -p avec support de session. Exemple : cband continue <session-id> 'quel était le résultat de la recherche ?'
• Démon HTTP pour un contrôle de session à distance ou sans interface : Démarrer avec cband serve --host 127.0.0.1 --port 7842, puis se connecter avec cband --connect localhost:7842 "démarrer un plan de migration"
• Serveur ACP pour l'intégration d'éditeurs et d'interfaces alternatives : Exécuter cband acp --model opus ou cband acp --model haiku pour activer l'intégration avec des outils comme Toad ou Zed
• Bibliothèque TypeScript pour intégrer ces flux de travail dans des outils personnalisés
• Gestion des sessions : cband sessions liste les sessions actives suivies, cband sessions close --all ferme toutes les sessions contrôlées

Configuration et prérequis

Les prérequis incluent Node.js ou Bun, une installation déjà authentifiée de Claude Code, et tmux pour des flux de travail locaux et assistés par démon de première classe. Options d'installation :

# utilisation ponctuelle
npx @halfwhey/claudraband "examiner la différence mise en scène"

installation globale
npm install -g @halfwhey/claudraband

Le paquet installe à la fois claudraband et cband (raccourci recommandé). Il inclut Claude Code @anthropic-ai/[email protected] mais permet de le remplacer avec la variable d'environnement CLAUDRABAND_CLAUDE_PATH.

Exemples de flux de travail

La source montre plusieurs cas d'utilisation pratiques :

• Sessions persistantes locales : cband "auditer le dernier commit et me dire ce qui semble risqué"
• Auto-interrogation : Claude peut interroger une ancienne session Claude et justifier les choix qu'elle a faits
• Interfaces alternatives : Toad ou Zed peuvent utiliser claudraband acp comme interface alternative pour Claude Code
• Intégration de bibliothèque : Les exemples TypeScript incluent la revue de code, la gestion multi-sessions et la journalisation de sessions

Détails techniques

Les sessions sont suivies dans ~/.claudraband/. Le démon utilise par défaut tmux comme environnement d'exécution de terminal. Une option expérimentale --backend xterm existe pour un repli sans interface mais est plus lente que tmux. Le projet est marqué comme expérimental et évolue au fur et à mesure que Claude Code et les clients ACP changent.

Avertissement important : Ce n'est pas un remplacement du SDK Claude et est orienté vers une utilisation personnelle et ad hoc. Il ne gère pas OAuth ni ne contourne l'interface TUI de Claude Code - chaque interaction passe par une vraie session Claude Code.