Skip to content

Add Claude Sessions Viewer block with GUI interface #3304

Description

@kcisoul

Summary

Add a new block view type (claudesessions) that displays Claude Code sessions in a rich GUI interface, similar to the Claude app's conversation list. Currently, Claude Code interaction in Wave is TUI-only — this provides a visual dashboard for browsing and resuming sessions.

Use Cases

  • Browse recent Claude Code sessions across all projects at a glance
  • Quickly resume a previous Claude session by clicking on it
  • Monitor active sessions in real-time
  • Navigate sessions via keyboard (arrow keys) or mouse

Proposed Implementation

Backend (Go)

  • Add ClaudeSessionInfo type and ClaudeSessionsListCommand RPC to read and parse ~/.claude/history.jsonl and ~/.claude/sessions/*.json
  • Aggregate session data: project name, message count, timestamps, first message preview
  • Return up to 50 most recent sessions sorted by last activity

Frontend (React + Jotai)

  • New view type claudesessions with ViewModel + component
  • List view with sessions grouped by date (Today, Yesterday, Last 7 Days, Older)
  • Each item shows: project name, first message preview, relative timestamp, message count
  • Full keyboard navigation (arrow keys, Enter to open, Escape to clear search)
  • Mouse click to open/resume a session in a new terminal block
  • Search/filter functionality
  • Periodic polling (5s interval) to observe ~/.claude/ directory for real-time updates

Registration

  • Register in BlockRegistry
  • Add default widget entry in widgets.json

Design

  • Claude-branded styling with purple accent
  • Conversation list layout similar to Claude app
  • Active sessions indicated with a green dot
  • Responsive layout that adapts to block size

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions