kb tui

kb-tui — Terminal User Interface

Language: Go (Bubble Tea + Wish) · Primary Maintainer: Tejaswini — Golang & TUI Design · Collaborator: Rupa — TUI Design & CLI Tooling

SSH-accessible terminal dashboard for KB operators — designed for headless server environments and zero-overhead incident response where a browser isn't available or desirable.

Features

• Live process table with zone colors (green/yellow/red — Safe/Suspicious/Borderlands)
• Real-time alert feed
• Agent swarm status view
• Keyboard-driven containment actions
• Served over SSH via Wish (the Charm SSH server) on port 2222

Structure

kb-tui/
├── cmd/           Entry point — --ssh (production) or --local (dev terminal)
├── internal/
│   ├── ui/         Bubble Tea models and views
│   ├── client/      gRPC client for the Control Plane
│   └── styles/      Lipgloss style definitions
└── tests/

Access

ssh operator@kb-server -p 2222

Run Locally

cd kb-tui
go run cmd/main.go

Modes

• --ssh — serve the TUI over SSH (Wish, port 2222) — production mode
• --local — run directly in the current terminal — dev mode

Tests

go test ./...

See also: Architecture (Layer 4 — Operator Interface), kb-control-plane (gRPC backend), kb-dashboard (the browser-based alternative surface).