Documentation
¶
Overview ¶
Package tui is the full-screen Bubble Tea front-end of whisper-cli v2: a btop/k9s- grade dashboard to manage AND watch agents. It reuses internal/client for every control-plane call and internal/model for the view data, so the TUI and the scriptable Cobra surface share ONE implementation (DRY).
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func Run ¶
Run starts the full-screen TUI with the given options and blocks until the user quits. It uses the alt-screen + mouse cell-motion (so the dashboard owns the screen and click/scroll work); on exit it restores the terminal. A start error is returned to the caller (cmd/whisper) to render cleanly - never a panic onto the terminal.
Types ¶
type App ¶
type App struct {
// contains filtered or unexported fields
}
App is the root Bubble Tea model. It holds the whole TUI state and folds every message - key, resize, async result, stream event, tick - into a re-render.
func (*App) Init ¶
Init kicks off the first fleet load, the render tick, the live stream, and the monitor's op:logs backfill (the merged AGENTS dashboard shows the live monitor from frame one, so its history seed belongs at launch, not behind a tab switch). A launch straight onto EXPLORE (whisper explore [node]) also fires its first live land here, since onEnterMode only runs on a tab SWITCH.
func (*App) SelectedAgent ¶
SelectedAgent returns the currently-selected agent (zero value when the fleet empty).
type Options ¶
type Options struct {
Client *client.Client
Tenant string // best-effort tenant handle for the header (opaque t<sha256>)
Node string // emitting node hint (e.g. "ns1"); cosmetic
ThemeName theme.Name
NoColor bool
Light bool
StartAgent string // optional /128 to focus the monitor on at launch
StartOnMon bool // launch with the merged dashboard focused on StartAgent (whisper monitor <addr>)
StartOnExplore bool // open straight on the EXPLORE tab (whisper explore [node])
StartNode string // optional node to land the explorer on (the fetch is not wired yet)
Version string
}
Options configures a TUI run (resolved once in cmd/whisper).
Source Files
¶
- app.go
- chain.go
- commands.go
- explore_catalog.go
- explore_commands.go
- explore_fixtures.go
- explore_layout.go
- explore_model.go
- explore_palette.go
- explore_render.go
- keys.go
- layout.go
- livegraph.go
- livestrip.go
- logo.go
- logo_gen.go
- messages.go
- modals.go
- monitorstate.go
- overlays.go
- palette.go
- run.go
- stream.go
- views_agents.go
- views_config.go
- views_explore.go
- views_graph.go
- views_logs.go
- views_monitor.go
- views_policy.go
Directories
¶
| Path | Synopsis |
|---|---|
|
Package components holds the reusable Lip Gloss render helpers the views compose: the braille sparkline, the gauge, and small formatters.
|
Package components holds the reusable Lip Gloss render helpers the views compose: the braille sparkline, the gauge, and small formatters. |
|
Package theme is the single styling surface for the whisper TUI.
|
Package theme is the single styling surface for the whisper TUI. |