Skip to content

feat(board): interactive Claude Code sessions in browser#8

Merged
jonathanpeterwu merged 1 commit intomainfrom
feature/STA-575-board-interactive-sessions
Apr 3, 2026
Merged

feat(board): interactive Claude Code sessions in browser#8
jonathanpeterwu merged 1 commit intomainfrom
feature/STA-575-board-interactive-sessions

Conversation

@jonathanpeterwu
Copy link
Copy Markdown
Collaborator

Summary

  • Board server (tools/agent-viewer/server.cjs): Express + Socket.io that spawns claude --output-format stream-json with stdin pipe open, streams output to browser via WebSocket
  • Frontend (tools/agent-viewer/public/index.html): Nothing-design UI with xterm.js terminal, kanban sidebar for conductor agents + interactive sessions, new session modal
  • CLI stackmemory board: finds server via package path resolution, auto-opens browser

Closes STA-575

Test plan

  • stackmemory board launches server and opens browser
  • Click "+ NEW", enter prompt, verify Claude session spawns
  • Verify stream-json output renders in xterm.js terminal
  • Send message via input bar, verify it reaches agent stdin
  • Kill session via KILL button, verify exit event renders
  • Refresh page, verify session list persists and reconnects
  • Verify conductor agent cards populate from ~/.stackmemory/conductor/agents/

- Board server (tools/agent-viewer/server.cjs): Express + Socket.io
  - Spawns claude --output-format stream-json with stdin pipe open
  - WebSocket streaming of agent output to browser clients
  - REST API: /api/agents, /api/sessions, /api/sessions/:id/message
  - Session persistence and reconnection support
  - Scans conductor agent statuses from ~/.stackmemory/conductor/

- Frontend (tools/agent-viewer/public/index.html): Nothing-design
  - xterm.js terminal for live Claude Code output rendering
  - Sidebar: active sessions + conductor agent cards with phase bars
  - New session modal: prompt + model selection
  - Real-time WebSocket streaming, input bar for user messages
  - Dark mode, Space Mono/Grotesk/Doto typography

- CLI: `stackmemory board` finds server via package path resolution
  - Auto-opens browser on launch
@jonathanpeterwu jonathanpeterwu merged commit d2b5ce8 into main Apr 3, 2026
3 of 6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant