Skip to content

Enhancement: Real-time session activity indicators and notifications #18

@vultuk

Description

@vultuk

Description

Add comprehensive activity indicators and notifications to monitor session status and important events across multiple sessions.

Current Problem

  • No visibility into background session activity
  • Missing important events in inactive sessions
  • No way to know when long-running commands complete
  • Difficult to identify which sessions need attention

Visual Indicators

Session Status Icons

  • 🟢 Active: Currently receiving output
  • 🟡 Idle: No activity for 30+ seconds
  • 🔵 Input Required: Waiting for user input
  • 🔴 Error: Command failed or session crashed
  • ⏸️ Paused: Session suspended
  • 🔄 Processing: Command running
  • Completed: Last command successful
  • ⚠️ Warning: Non-zero exit code

Activity Sparklines

  • Mini graph showing activity over time
  • CPU/Memory usage indicators
  • Network I/O visualization
  • Output rate (lines per second)

Progress Indicators

  • Command execution timer
  • Progress bars for recognized operations (npm install, git clone, etc.)
  • Estimated time remaining for common tasks
  • Spinner animations for active processes

Notification System

Browser Notifications

  • Command completion alerts
  • Error notifications for background sessions
  • Input required notifications
  • Session disconnect warnings
  • Configurable notification preferences

In-App Notifications

  • Toast messages for important events
  • Badge counts on tabs/sessions
  • Status bar with recent events
  • Activity feed sidebar

Smart Notifications

  • Pattern matching for important output (e.g., "ERROR", "FAILED")
  • Regex-based custom alerts
  • Threshold alerts (execution time > X)
  • Silence notifications during focus mode

Session Monitoring Dashboard

Overview Panel

┌─────────────────────────────────────┐
│ Active Sessions: 5                  │
│ ├─ Running: 3                       │
│ ├─ Idle: 1                          │
│ └─ Waiting: 1                       │
│                                     │
│ Resource Usage:                     │
│ ├─ CPU: ████████░░ 76%             │
│ └─ Memory: ██████░░░░ 52%          │
│                                     │
│ Recent Events:                      │
│ • Build completed (Frontend)        │
│ • Error in Backend API              │
│ • Database backup finished          │
└─────────────────────────────────────┘

Per-Session Metrics

  • Command history with execution times
  • Success/failure rate
  • Average response time
  • Peak resource usage
  • Session uptime

Advanced Features

Activity Patterns

  • Learn common patterns to predict completion
  • Identify anomalies in session behavior
  • Suggest optimizations based on usage

Custom Triggers

// Example trigger configuration
{
  "triggers": [
    {
      "pattern": "Build successful",
      "action": "notify",
      "sound": true
    },
    {
      "pattern": "FATAL ERROR",
      "action": "focus_session",
      "alert": "critical"
    }
  ]
}

Session Health Score

  • Overall health rating (0-100)
  • Based on error rate, response time, resource usage
  • Visual health bar with color coding
  • Recommendations for improvement

Implementation Details

Performance Considerations

  • Debounce rapid updates
  • Use Web Workers for processing
  • Lazy load indicators for hidden sessions
  • Efficient WebSocket message batching

Accessibility

  • Screen reader support for status changes
  • Keyboard navigation for notifications
  • High contrast mode for indicators
  • Alternative text for visual elements

Benefits

  • Never miss important events
  • Better multi-session management
  • Improved debugging capabilities
  • Reduced context switching
  • Proactive issue detection

Configuration Options

  • Enable/disable specific indicators
  • Customize notification thresholds
  • Set quiet hours for notifications
  • Configure indicator update frequency
  • Choose notification channels (visual, audio, system)

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions