feat(agent): experimental Claude (Interactive) backend (tmux + sidecar host) - #855

Open

codefriar wants to merge 95 commits into

utensils:mainfrom

codefriar:codefriar/emerald-cypress

Commits on May 22, 2026

docs(superpowers): add interactive-claude tmux/sidecar design spec

authored and
jamesbrink
committed
docs(superpowers): add interactive-claude tmux/sidecar implementation plan

authored and
jamesbrink
committed
feat(settings): add claudeInteractiveEnabled experimental flag

codefriar
authored and
jamesbrink
committed
test(settings): reset claudeInteractiveEnabled before each test

codefriar
authored and
jamesbrink
committed
feat(settings): persist claudeInteractiveEnabled via app_settings

authored and
jamesbrink
committed
feat(db): add interactive_sessions table migration

codefriar
authored and
jamesbrink
committed
feat(db): add interactive_sessions CRUD helpers

codefriar
authored and
jamesbrink
committed
fix(db): error on missing-sid interactive_sessions updates + cover list ordering

codefriar
authored and
jamesbrink
committed
feat(agent): add interactive_protocol wire types

codefriar
authored and
jamesbrink
committed
feat(agent): add length-prefixed JSON-line framing

codefriar
authored and
jamesbrink
committed
test(agent): add stub-tui fixture for interactive host tests

codefriar
authored and
jamesbrink
committed
feat(agent): define InteractiveHost trait and shared types

codefriar
authored and
jamesbrink
committed
fix(agent): re-export HostSessionSummary; clean up interactive_host placeholders

codefriar
authored and
jamesbrink
committed
test(agent): add InteractiveHost conformance suite skeleton

codefriar
authored and
jamesbrink
committed
fix(agent): make conformance status subtest self-contained; drop dupe import

codefriar
authored and
jamesbrink
committed
feat(agent): add tmux availability check with TTL cache

codefriar
authored and
jamesbrink
committed
fix(agent): robust tmux version parsing for pre-release suffixes

codefriar
authored and
jamesbrink
committed
feat(session-host): scaffold claudette-session-host crate

codefriar
authored and
jamesbrink
committed
fix(session-host): honor RUST_LOG env var for tracing

codefriar
authored and
jamesbrink
committed
feat(session-host): accept connections and answer Hello handshake

codefriar
authored and
jamesbrink
committed
fix(session-host): propagate serde errors in handshake; gate test cfg(unix)

codefriar
authored and
jamesbrink
committed
feat(session-host): EnsureSession + Status + SendInput + Stop

authored and
jamesbrink
committed
fix(session-host): drop map lock before inner-field await; document Stop exit_status semantics

codefriar
authored and
jamesbrink
committed
feat(session-host): Attach streaming, Detach (via close), Resize, CaptureScreen

codefriar
authored and
jamesbrink
committed
fix(session-host): warn on attach subscriber lag; document capture_screen race

codefriar
authored and
jamesbrink
committed
feat(session-host): idle-exit when no sessions and no clients

authored and
jamesbrink
committed
feat(agent): SidecarHost client passes InteractiveHost conformance

codefriar
authored and
jamesbrink
committed
feat(agent): TmuxHost passes InteractiveHost conformance

authored and
jamesbrink
committed
fix(agent): propagate tmux kill-session errors; add tracing to TmuxHost

codefriar
authored and
jamesbrink
committed
feat(agent): TmuxHost::reconcile returns sessions killed externally

codefriar
authored and
jamesbrink
committed
feat(cli): add 'chat hook' subcommand for Claude Code hook events

authored and
jamesbrink
committed
feat(tauri): route 'chat hook' IPC into per-session interactive channels

authored and
jamesbrink
committed
feat(agent): settings overlay materializes Claude Code hooks

codefriar
authored and
jamesbrink
committed
feat(agent): add ClaudeInteractive harness variant and backend resolver branch

codefriar
authored and
jamesbrink
committed
feat(agent): InteractiveSession::start with host selection

codefriar
authored and
jamesbrink
committed
fix(agent): use platform-correct shell quoting for hook commands

codefriar
authored and
jamesbrink
committed
feat(tauri): interactive_start/send_input/attach/capture_screen/stop commands

authored and
jamesbrink
committed
fix(tauri): wire interactive hook channel in start/stop; surface capture DB errors

codefriar
authored and
jamesbrink
committed
build(tauri): bundle claudette-session-host as externalBin sidecar

codefriar
authored and
jamesbrink
committed
fix(tauri): forward --release-built to session-host stage; add CLAUDETTE_CLI env override

codefriar
authored and
jamesbrink
committed
feat(ui): add Claude (Interactive) toggle to Experimental settings

authored and
jamesbrink
committed
feat(ui): expose Claude (Interactive) runtime card gated by experimental flag

authored and
jamesbrink
committed
fix(ui): honor claude_interactive harness override in effectiveHarness when flag is on

codefriar
authored and
jamesbrink
committed
feat(ui): add interactive Tauri bridge service

codefriar
authored and
jamesbrink
committed
fix(ui): preserve unknown-kind label on flat hook path; export RawHookPayload types

codefriar
authored and
jamesbrink
committed
feat(ui): hook-delimited turn assembler for interactive sessions

authored and
jamesbrink
committed
fix(ui): reset turn assembler state on sid change; pin turn-id numbering

codefriar
authored and
jamesbrink
committed
feat(ui): InteractiveTurnView renders per-turn xterm.js

authored and
jamesbrink
committed
fix(ui): retain InteractiveTurnView bytes across resize; assert dispose

codefriar
authored and
jamesbrink
committed
feat(ui): wire ChatPanel to interactive backend (embedded + full-terminal modes)

authored and
jamesbrink
committed
feat(ui): sidebar badges for interactive session state

authored and
jamesbrink
committed
fix(ui): tighten InteractiveSessionRow.state to a typed union

codefriar
authored and
jamesbrink
committed
feat(ui): copy tmux attach command for interactive sessions on Unix

codefriar
authored and
jamesbrink
committed
fix(ui): use Tauri clipboard plugin for tmux attach copy

codefriar
authored and
jamesbrink
committed
feat(tauri): reattach surviving interactive sessions on startup

authored and
jamesbrink
committed
fix(tauri): single DB open in boot reconciler

codefriar
authored and
jamesbrink
committed
feat(tauri): stop interactive sessions when workspaces are deleted

authored and
jamesbrink
committed
fix(agent): skip stopped sessions on teardown; align sid-cleanup comment

codefriar
authored and
jamesbrink
committed
feat(interactive): detect and clean up orphaned interactive sessions

authored and
jamesbrink
committed
fix(interactive): exclude non-running host sessions from orphan detection

codefriar
authored and
jamesbrink
committed
docs(site): describe interactive-claude experimental backend

authored and
jamesbrink
committed
docs: document interactive-claude backend in CLAUDE.md + copilot instructions

codefriar
authored and
jamesbrink
committed
fix(interactive): final review pass — state vocabulary, screen blob, tmux bytes, flag gate

authored and
jamesbrink
committed
docs(superpowers): coverage plan for interactive-claude patch set (>=85%)

authored and
jamesbrink
committed
chore(ci): add interactive-claude coverage gate (vitest)

authored and
jamesbrink
committed
fix(ci): align @vitest/coverage-istanbul to caret range with vitest

codefriar
authored and
jamesbrink
committed
chore(ci): gate Claude Interactive patch at >=85% via cargo llvm-cov

authored and
jamesbrink
committed
test(agent): cover SidecarHost ConnHandle fault paths

codefriar
authored and
jamesbrink
committed
test(agent): cover frame truncation and zero-length payloads

codefriar
authored and
jamesbrink
committed
test(agent): cover SettingsOverlay I/O failures and idempotent cleanup

codefriar
authored and
jamesbrink
committed
test(interactive): cover reattach_rows DB-write isolation

codefriar
authored and
jamesbrink
committed
test(interactive): empty-input fast paths skip host.status

codefriar
authored and
jamesbrink
committed
test(session-host): document reader Ok(0) and waiter Err paths as unreachable

authored and
jamesbrink
committed
test(session-host): cover lagged broadcast subscriber path

codefriar
authored and
jamesbrink
committed
test(session-host): cover Hello version mismatch returning HelloNack

codefriar
authored and
jamesbrink
committed
test(tauri): cover boot reconciler branches

authored and
jamesbrink
committed
test(tauri): cover interactive_* command handlers

authored and
jamesbrink
committed
test(tauri): interactive session teardown fires on workspace archive + delete

authored and
jamesbrink
committed
test(cli): cover chat hook IPC failure paths

codefriar
authored and
jamesbrink
committed
test(ui): cover xterm onData → sendInput keystroke path

authored and
jamesbrink
committed
test(ui): cover services/interactive rejection paths

codefriar
authored and
jamesbrink
committed
test(ui): cover App.tsx orphan-detected listener wiring

authored and
jamesbrink
committed
test(ui): cover turn-assembler buffering and post-stop Exit

codefriar
authored and
jamesbrink
committed
test(ui): cover InteractiveTerminalMode promise-rejection and race paths

codefriar
authored and
jamesbrink
committed
test(ui): cover InteractiveBadge mixed-state precedence + state exhaustiveness

codefriar
authored and
jamesbrink
committed
chore(ci): enforce Claude Interactive patch coverage at >=85%

authored and
jamesbrink
committed
fix(interactive): final coverage cleanup — orphan listener catch, tightened test, FIXME on SidecarHost reconnect

codefriar
authored and
jamesbrink
committed
fix(rebase): align interactive backend with post-rebase main
jamesbrink
committed
fix(stub-tui): bump fixture crate to 0.25.0 for workspace version sync
jamesbrink
committed
test(session-host): widen attach READY timeouts for slow CI/llvm-cov
jamesbrink
committed
fix(tauri): supply missing input_values / required_inputs in test fixtures
jamesbrink
committed
feat(ui): expose Claude (Interactive) runtime selection behind experimental flag

codefriar
and
claude
committed
fix(ui): mock effectiveHarness with flag guard; fix doc comment typos
codefriar
committed
chore: document stub-tui fixture; add src-session-host to version-sync gate

codefriar
and
claude
committed
test(session-host): gate stub-tui READY behind STUB_TUI_DELAY_MS to deflake lag test

codefriar
and
claude
committed