🎯 Warren

Central Hub for Distributed Coding Agent Sessions

✅ Phase 2 Complete
100%
Phase 2 Complete
46+
Tests Passing
4,800+
Lines of Code
37+
Files Changed

Phase 1: Topology + Capture Validation

✅ Complete
100%
  • ✓ Server Model (local/remote support, SSH pooling)
  • ✓ Tmux Topology Discovery (sessions, windows, panes)
  • ✓ Pane Capture (content extraction, ANSI stripping)
  • ✓ Pane Control (send text, send keystrokes)
  • ✓ Control Loop Validation (capture → validate → action → verify)

Phase 2: Central Read-Only Hub

✅ Complete
100%
  • ✓ Agent Session Registry (with JSON persistence)
  • ✓ Event Store (SQLite-based activity tracking)
  • ✓ Activity Parser (chat, file ops, tool usage extraction)
  • ✓ State Detection (enhanced with time-decay, improved question detection)
  • ✓ Artifact Profile Extraction (file tracking, repo detection)
  • ✓ Notification Engine (actionable state alerts)
  • ✓ Terminal UI (Bubble Tea, keyboard navigation)
  • ✓ Web Interface (REST API, WebSocket, responsive frontend)
  • ✓ Conversation History Display (TUI + Web, full Claude session access)

🎯 Key Features Delivered

🔍 State Detection

  • Enhanced idle detection (30s timeout)
  • Stricter question patterns
  • Time-decay system (100% → 50% → 20%)
  • Priority-based resolution

💬 Conversation History

  • Full Claude Code session access
  • TUI viewer (press 'c')
  • Web display (Conversation tab)
  • Remote SSH support

💾 Registry Persistence

  • JSON storage (.warren/registry.json)
  • Atomic writes (temp + rename)
  • Merge discovered sessions
  • Auto-prune stale sessions (>24h)

🖥️ User Interfaces

  • Terminal UI (Bubble Tea)
  • Web dashboard (real-time)
  • Keyboard navigation
  • WebSocket updates

📝 Recent Commits

6771b38 - docs: update ROADMAP and README for registry persistence completion
2dd15da - feat: Implement agent session registry persistence
0089b3f - fix: add warren-tui binary to .gitignore
b3b219a - docs: update ROADMAP with Phase 2 completion details
d8d9d09 - docs: update README and getting-started with Phase 2 conversation features
fb33316 - fix: web message display and TUI session registry
7e3780c - Merge topology integration: Complete Phase 2 conversation display

🚀 Next Steps: Phase 3

Phase 3 will add interactive capabilities, allowing users to act on sessions directly from Warren without attaching to tmux.

  • ☐ Action Framework (send text, keystrokes, approve/deny)
  • ☐ Permission Response (approve/deny from TUI/Web)
  • ☐ Question Response (reply to agent questions)
  • ☐ Message Sending (send messages to agents)
  • ☐ Permission Mode Rotation (cycle through modes)
  • ☐ Notification-to-Action Flow (quick actions from notifications)