net-deck-0.44.1 is not a library.

NET Deck

The operator cyberdeck — a terminal UI for the NET mesh.

Live, streaming, low-latency visibility into MeshOS, MeshDB, RedEX, and Dataforts, with signed admin actions on top. Built with ratatui + crossterm. Matrix palette, neon-green on pitch black.

Deck — NET.MAP

Install

# crates.io
cargo install net-deck

# prebuilt binary (no compile)
cargo binstall net-deck

# npm (per-platform binary shim)
npm install -g @net-mesh/deck

# PyPI (maturin-built wheel, bundles the binary)
pip install net-deck

Prebuilt tarballs for linux (glibc + musl, x86_64 + aarch64), macOS (x86_64 + aarch64), and Windows (x86_64 + aarch64) are published to the GitHub Releases page under the deck-v* tag prefix.

Run

# Attach to a single-node in-process MeshOsRuntime
net-deck

# Boot a real 5-node in-process MeshOS cluster (dev-only)
cargo run -p net-deck --features demo

The demo feature wires net_sdk::testing::ClusterHarness — real daemons, real migrations, real blob adapters, a real RpcObserver feeding the NRPC tail. See docs/internal/plans/DECK_DEMO_PLAN.md.

Tabs

Tab	What it shows
`NET.MAP`	Live mesh topology — nodes, RTT, health, avoid-lists, maintenance, replica heat.
`NODES`	Per-node inventory: CPU / mem / disk, saturation trend, capability set, versions.
`DAEMONS`	Per-daemon supervision — health, saturation, restarts, crash-loops, log tail.
`DATAFORTS`	Replica & placement: desired vs actual, migrations, pulls, eviction, 5-axis score.
`BLOBS`	Object inventory across every wired adapter — heat, ancestry, shard layout.
`MIGRATIONS`	In-flight + recent migrations with byte progress and stall detection.
`CHAINS`	Replica density by artifact, drift, placement stability.
`GROUPS`	Replica / fork / standby groupings.
`SUBNETS`	Subnet membership and gateway routing.
`GATEWAYS`	Gateway daemons — bridges into the mesh from outside transports.
`AGGREGATORS`	Aggregator-daemon attach / scale state, remote-attach RPC tail.
`NRPC`	Live nRPC call tail — request / response / failure stream across the cluster.
`LOGS`	High-speed log matrix — node → daemon → line, with filter + follow.
`AUDIT`	RedEX-committed operator audit ledger.

Deck — NODES Deck — DATAFORTS

Admin surface — signed ops

Every admin action propagates as a signed event on the admin chain via RedEX:

drain / cordon / uncordon node
enter / exit maintenance
drop replicas, invalidate placement
restart daemons, clear avoid lists
ICE: freeze / thaw cluster, flush avoid-lists, force-evict-replica, force-restart-daemon, force-cutover, kill-migration

Before an ICE action commits, Deck runs a blast-radius simulation — "This action affects 4 nodes, 12 replicas, and 2 daemons. Continue?" — then signs with the operator key loaded from the maintenance node.

Operator signatures are verified against an AdminVerifier OperatorRegistry — the built-in runtime (the single-node default and the --features demo cluster) wires a single operator keypair at threshold 1. Multi-operator M-of-N verification requires a populated registry and a raised threshold.

Bookmarks (multi-cluster)

Saved cluster contexts live at $XDG_CONFIG_HOME/net-deck/bookmarks.toml (or the platform equivalent — see dirs). First-run with no config dir yields an empty store; a corrupt file is renamed aside (<path>.corrupt-<ms>) and an empty store returned.

License

MIT OR Apache-2.0. See LICENSE-MIT and LICENSE-APACHE.