How sam0uly/bubblemonitor works
bubbleMonitor is a terminal system monitor: users launch the BubbleTea interface, which periodically requests system and process data, stores it in application state, and renders it in interactive tabs and overlays. Its documented capabilities also include remote SSH monitoring, health analysis, alerts, and snapshot export; their exact runtime wiring is not fully visible in the sampled excerpts. The graph includes those subsystems at supported paths, but omits uncertain links. Evidence is limited to the README and the supplied excerpts and source index.
Main entry points: model.go App model · adapters.go Provider adapters · groups.go Monitor state · update.go Event update
Components 22
Entry points
- Interactive TUI
cmd/bub/main.go - CLI commands
cmd/bub/root.go
Application flow
- App model
internal/app/model.go - Event update
internal/app/update.go - Keyboard handling
internal/app/handlers/keyboard.go
Data providers
- Provider adapters
internal/provider/adapters.go - System metrics
internal/provider/system/hardware.go - Service discovery
internal/provider/system/services.go - Process operations
internal/provider/process/list.go - SSH monitoring
internal/provider/remote/ssh.go - System capabilities
internal/provider/system
State and analysis
- Monitor state
internal/data/groups.go - Async messages
internal/msg/messages.go - Threshold alerts
internal/data/alerts.go - Health analysis
internal/app/analysis.go - Snapshot export
internal/app/export.go - Configuration
internal/config/config.go
Terminal interface
- TUI layout
internal/ui/layout.go - Monitor tabs
internal/ui/tabs/system.go - Help and settings
internal/ui/overlays/help.go - Metric charts
internal/ui/widgets/charts.go
Other components
- Terminal user
Connections 31
- Terminal user → Interactive TUI: launches
- Terminal user → CLI commands: runs commands
- Interactive TUI → App model: creates
cmd/bub/main.go - App model → Provider adapters: initializes
internal/app/model.go - App model → Monitor state: initializes
internal/app/model.go - App model → Configuration: loads
internal/app/model.go - App model → TUI layout: uses
internal/app/model.go - Event update → Keyboard handling: dispatches
internal/app/update.go - Event update → Provider adapters: requests metrics
internal/app/update.go - Event update → Monitor state: updates
internal/app/update.go - Event update → Async messages: handles
internal/app/update.go - Keyboard handling → Configuration: saves settings
internal/app/handlers/keyboard.go - Keyboard handling → Process operations: requests files
internal/app/handlers/keyboard.go - Provider adapters → System metrics: delegates
internal/provider/adapters.go - Provider adapters → Process operations: delegates
internal/provider/adapters.go - Provider adapters → SSH monitoring: delegates
internal/provider/adapters.go - System metrics → Async messages: returns metrics
- Service discovery → Async messages: returns services
internal/provider/system/services.go - Service discovery → Monitor state: uses service types
internal/provider/system/services.go - SSH monitoring → Async messages: returns remote data
internal/provider/remote/ssh.go - SSH monitoring → Monitor state: populates metrics
internal/provider/remote/ssh.go - TUI layout → Monitor tabs: renders
internal/ui/layout.go - TUI layout → Help and settings: renders
internal/ui/layout.go - TUI layout → Metric charts: uses
internal/ui/layout.go - Monitor tabs → Monitor state: reads
- Monitor tabs → Metric charts: uses
- Terminal user → SSH monitoring: configures SSH
- Terminal user → Threshold alerts: sets thresholds
- Terminal user → Health analysis: views health score
- Terminal user → Snapshot export: exports snapshot
- System capabilities → Terminal user: reports system data