ClaudeBox

Claude Code agent execution and conversation management.

Overview

ClaudeBox is a Python toolkit that bridges Claude Code to Rhea infrastructure. It serves two primary purposes:

1. Agent HTTP Wrapper - Exposes the Claude Agent SDK over HTTP with SSE streaming, enabling remote clients and other agents to run Claude subagents
2. Conversation History Daemon - Captures Claude Code sessions and stores them in the database for querying and analysis

Architecture

┌─────────────────────────────────────────────────────────────┐
│                      ClaudeBox                               │
├─────────────────────────────┬───────────────────────────────┤
│      Agent HTTP API         │      Conversation Daemon       │
│                             │                                │
│  POST /chat (SSE stream)    │  Watches ~/.claude/inbox       │
│  GET /health                │  Parses transcripts            │
│                             │  Stores to PostgreSQL          │
│  Uses Claude Agent SDK      │  Dead-letter queue             │
└─────────────────────────────┴───────────────────────────────┘
                │                           │
                ▼                           ▼
        ┌───────────────┐          ┌───────────────┐
        │  MCP Servers  │          │  Argus DB     │
        │  (janus, etc) │          │  (postgres)   │
        └───────────────┘          └───────────────┘

Key Features

• Streaming Agent Execution - Run Claude agents via HTTP with real-time SSE streaming
• MCP Tool Access - Agents can use any configured MCP servers (janus, context7, magic-mcp, etc.)
• Session Resumption - Continue conversations across requests
• Conversation Search - Full-text search across all Claude Code sessions
• Usage Analytics - Track tool usage, file modifications, session patterns
• Custom Subagents - Create specialized agents with curated tool sets

Components

Component	Purpose	Port
claudebox-agent	HTTP API for agent execution	8765
claudebox-daemon	Conversation capture daemon	-

Quick Links

• Agent HTTP API - Running agents programmatically
• Conversation Daemon - How sessions are captured
• Hooks - Claude Code hook integration
• Custom Agents - Creating specialized subagents (Venus pattern)
• Daniel's Agents - Agent registry and ask_agent dispatcher

Installation

# Clone and install
cd ~/repos-meetrhea/claudebox
pip install -e .

# Deploy systemd services
./deploy.sh

# Check status
systemctl --user status claudebox-agent
systemctl --user status claudebox-daemon

Browsing Conversations

View captured conversations at: https://argus.meetrhea.com/claudebox

Or query via Janus MCP:

janus_claudebox_list     # List recent sessions
janus_claudebox_search   # Full-text search
janus_claudebox_stats    # Usage analytics