bee-tui

Production-grade k9s-style terminal cockpit for Ethereum Swarm Bee node operators.

Status: pre-implementation. Plan v2 canonical at docs/PLAN.md. Initial scaffold from the ratatui component template. No working screens yet — see docs/STATUS.md for current session pin.

What this is

bee-tui is the operator's truth-teller — a live terminal cockpit that surfaces the state Bee's API hides:

Bucket collisions before utilization says 100%
Redistribution skip reasons (LastPlayedRound is misleading)
Health gates with WHY (storageRadius vs committedDepth, 30-min wakeup tick)
NAT reality (libp2p AutoNAT under symmetric NAT)
HTTP request log so operators trust what's happening

Built on top of bee-rs, the Rust client for Bee.

Status

Pre-implementation. The plan has been validated against:

~50 GitHub issues across ethersphere/bee, swarm-cli, bee-dashboard for operator pain points
Bee node source for stamp / redistribution / accounting / sync internals
Decentralized-storage TUI prior art (lntop, ipfs-tui, k9s)
2026 Ratatui ecosystem state-of-the-art

See docs/research/ for the eight research streams.

Roadmap

Version	Scope
v0.1	S1 Health gates, S2 Stamps, S10 Command log; single-node
v0.2	S3 SWAP, S4 Lottery + rchash benchmark
v0.3	S5 Warmup, S6 Peers, S7 NAT, S8 RPC
v0.4	Multi-node, `:context` switcher, diagnostic bundle
v0.5	S9 Uploads (chunks/stream WS), theme system
v1.0	Polish, mdBook docs, awesome-swarm PR

Full roadmap and screen specs in docs/PLAN.md.

Stack

Ratatui 0.30 — terminal UI framework
crossterm 0.29 — terminal backend
Tokio — async runtime
bee-rs ≥ 1.3.0 — Bee API client
Single static binary via cargo install bee-tui (when published)

License