Claudraband: Terminal Wrapper for Persistent Claude Code Sessions

What Claudraband Does
Claudraband is a wrapper for the official Claude Code TUI that runs it in a controlled terminal environment. This allows developers to maintain persistent Claude Code sessions, resume them later, answer pending prompts, expose sessions through a daemon, or drive them through the Anthropic Client Protocol (ACP).
Key Features and Commands
The tool provides several specific capabilities:
- Resumable non-interactive workflows: Essentially
claude -pwith session support. Example:cband continue <session-id> 'what was the result of the research?' - HTTP daemon for remote or headless session control: Start with
cband serve --host 127.0.0.1 --port 7842, then connect withcband --connect localhost:7842 "start a migration plan" - ACP server for editor and alternate frontend integration: Run
cband acp --model opusorcband acp --model haikuto enable integration with tools like Toad or Zed - TypeScript library for building these workflows into custom tools
- Session management:
cband sessionslists live tracked sessions,cband sessions close --allcloses all controlled sessions
Setup and Requirements
Requirements include Node.js or Bun, an already authenticated Claude Code installation, and tmux for first-class local and daemon-backed workflows. Installation options:
# one-off use
npx @halfwhey/claudraband "review the staged diff"
install globally
npm install -g @halfwhey/claudraband
The package installs both claudraband and cband (recommended shorthand). It bundles Claude Code @anthropic-ai/[email protected] but allows overriding with CLAUDRABAND_CLAUDE_PATH environment variable.
Workflow Examples
The source shows several practical use cases:
- Local persistent sessions:
cband "audit the last commit and tell me what looks risky" - Self-interrogation: Claude can interrogate an older Claude session and justify the choices it made
- Alternative frontends: Toad or Zed can use
claudraband acpas an alternative frontend for Claude Code - Library integration: TypeScript examples include code review, multi-session management, and session journaling
Technical Details
Sessions are tracked in ~/.claudraband/. The daemon defaults to using tmux as the terminal runtime. An experimental --backend xterm option exists for headless fallback but is slower than tmux. The project is marked as experimental and evolving as Claude Code and ACP clients change.
Important caveat: This is not a replacement for the Claude SDK and is geared toward personal, ad-hoc usage. It doesn't handle OAuth or bypass the Claude Code TUI - every interaction runs through a real Claude Code session.
📖 Read the full source: HN AI Agents
👀 See Also

Built AI Forensic Accounting Software with My Dad — CaseTrail Automates Financial Fraud Detection
A father-son team built CaseTrail, an AI-powered forensic accounting tool that ingests bank statements and identifies anomalies. The blog details integration with LLMs for transaction analysis.

Conduid: Trust Infrastructure Layer for MCP Servers Built with Claude
Conduid indexes over 25,000 MCP servers across GitHub, npm, PyPI, and major directories, scoring each 0-100 based on GitHub activity, security posture, documentation quality, and maintenance signals. The entire codebase was written with Claude by a solo founder.

Lore: A tool that extracts structured context from AI coding conversations
Lore is a browser-based tool built with Claude Code that extracts structured context from AI conversations, capturing decisions, TODOs, blockers, and resume checklists. It's a React + TypeScript PWA with a Chrome extension for direct conversation capture and context injection.

2026 Hermes Agent Alternatives Roundup: Self-Hosted Options from OpenClaw to memU Bot
A developer who has been running Hermes since launch tested every self-hosted and managed alternative after the ClawHub security mess. Key findings: OpenClaw (370k stars) but 9 CVEs in 4 days and ~20% malicious packages; TrustClaw rebuilt with OAuth/sandboxing; nanobot at ~4K lines Python with MCP; memU Bot with unique structured memory. Managed options include Perplexity Computer (19 models, $200/mo), Claude Cowork (opens real Mac apps), and KimiClaw (40GB RAG, locked to K2.5, Chinese data law). Full roundup at source.