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-op/kb-tui/
├── cmd/           Entry point — Wish SSH server
├── 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-op/kb-tui
go run cmd/main.go

Run tests

go test ./...

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