Source, releases, issues, merge requests, and CI all live on GitLab. This GitHub copy is a read-only mirror and may lag. Please file issues and get releases there.
The canonical, authoritative home of this project is GitLab — always:
This GitHub repository is a frozen, read-only mirror. All development, issues, and releases happen on GitLab. Please open issues and merge requests there. The full history of this stub is preserved on GitLab.
Multi-pane administrative console for the nclawzero distro.
Inspired by Novell NetWare's SYSCON — the IBM-character-mode TUI that managed every aspect of a NetWare server (users, groups, file system rights, server config, accounting) through hierarchical menus and modal forms.
zcon is the equivalent for nclawzero: one TUI to administer every
aspect of multi-agent fleet configuration on a single device — agents,
identities, credentials, network, storage, fleet topology, updates, logs,
supervisor actions.
Built on the same Turbo Vision substrate as zterm v0.3.
This project has not yet had significant code committed. It exists here as a positioned plan-of-record alongside its sibling projects zterm and ncz-tools, which are also alpha and unfinished.
Interfaces, file formats, screen layouts, and even the project name may change without notice. Do not depend on this for anything beyond exploration.
zcon is invoked as sudo zcon on a running nclawzero device and
provides a single TUI entry point for everything an operator might
otherwise need to do via separate tools (ncz, nmcli, systemctl,
journalctl, apt, hand-edited config files).
See docs/PLAN.md for the full pane-by-pane design.
- One screen, one job — each pane is a complete admin task surface. No cross-pane state, no clicks lost in tab-driven dialogs.
- Keyboard-first — every action is reachable from arrow keys + enter
- F-keys. Mouse support is incidental, never required.
- Dry-run before destructive — every write operation shows what it
will change before applying. Modeled after
kubectl --dry-run. - Operator's mental model is fleet-aware — actions taken on one device that should propagate (e.g., key rotation, MNEMOS sync) are surfaced as such, not hidden behind opaque commands.
- Reads are free, writes are gated — anyone with shell access can inspect; mutations require confirmation + audit-log entry.
- Composes with
ncz, not replaces it — zcon is a TUI front-end; the underlying mutations callnczsubcommands so scripted operators and zcon-driven operators converge on the same audit trail.
gitlab.com/perlowja/zterm— Rust TUI for chatting with the agents (different surface: zterm is for talking to the agents at runtime; zcon is for configuring the agents and the system around them).gitlab.com/nclawzero/ncz-tools—nczCLI for installing/managing agents on Pi/cixmini fleet devices. zcon's mutation paths callnczunder the hood for agent-lifecycle operations.gitlab.com/nclawzero/cix-installer— Debian-installer ISO that produces an nclawzero distro on Cix Sky1 hardware. Once installed,sudo zconis the canonical admin path.
Apache-2.0