Files
headquarter/openspec/changes/sessions-hub/proposal.md
Fusion 94aa88c154 feat: add Sessions Hub page
- Add Sessions tab to navigation between Dashboard and Projects
- Show active session count badge in navigation
- Create SessionsPage with:
  - Last session section with resume button
  - Active sessions grid with open/stop actions
  - Recent sessions list
  - Create session form with project/repo/tool selectors
- Add last_session_id to user config
- Update UserConfig schemas (backend and frontend)
- Add comprehensive CSS for sessions page

Quality gates: typecheck ✓, lint ✓, build ✓
2026-05-19 23:06:54 +02:00

1.8 KiB

Sessions Hub

Problem

Users currently have to navigate into individual projects and repositories to see their active tool instances (sessions). There's no centralized place to:

  • See all active/open sessions at a glance
  • Quickly access the last used session
  • Create new sessions without navigating deep into the project hierarchy

Solution

Create a dedicated Sessions Hub page that serves as the central place for managing tool instances:

  1. Navigation tab between Dashboard and Projects
  2. Active sessions section showing all running/open instances
  3. Last session prominently displayed for quick access
  4. Quick create - create sessions for any project from one place
  5. Persist last session in user config for easier access

Key Features

Sessions Page

  • Shows all active (running) sessions with status, type, and links
  • Shows recent sessions (last 5)
  • Shows last created session at the top for quick access
  • "New Session" button to create instances for any project

Navigation

  • New "Sessions" tab in the app shell between Dashboard and Projects
  • Shows count of active sessions as a badge

Quick Access

  • Last created session saved to user config
  • One-click to reopen/resume last session
  • Session history for quick navigation

Benefits

  • Faster workflow - No need to navigate deep into projects
  • Better visibility - See all active work at a glance
  • Quick resume - Jump back to last work instantly
  • Centralized management - One place for all sessions

Success Criteria

  • Sessions tab visible in navigation between Dashboard and Projects
  • Sessions page shows active sessions
  • Last session displayed prominently
  • Can create session for any project from Sessions page
  • Last created session persists in user config
  • Badge shows count of active sessions