Terminal UX • 12-Domain Neovim TUI, axonwall-tui & ZSH Workstation • v0.13.0

Neovim Super Configurator, axonwall-tui & CLI Reference

Axonwall treats the command line as a first-class cockpit. Connect over SSH or serial console to drive the 12-domain Neovim Super Configurator (axonwall-config), the standalone 11-tab Axonwall TUI & NastyMap Simulator (axonwall-tui), the declarative axonwallctl CLI, and a pre-tuned Oh My Zsh + Starship workstation.

1. Neovim Super Configurator (axonwall-config) — All 12 YAML Domains

axonwall-config (also accessible via axonwallctl config [domain]) launches an isolated Neovim Lua workspace mapping 1:1 to all 12 canonical YAML domain files in /etc/axonwall/, pairing structured multi-pane navigation with live diff and schema drawers:

Neovim Super Configurator 12-Domain TUI Layout (axonwall-config)
text
+------------------------+------------------------------------------------------------+
|  12 AXONWALL DOMAINS   |  [8] ha.yaml — High Availability & Fleet Satellites        |
|                        |  Path: /etc/axonwall/ha.yaml                    [MODIFIED] |
|  1. system             |------------------------------------------------------------|
|  2. interfaces         |  ha:                                                       |
|  3. firewall           |    enabled: true                                           |
|  4. routing            |    nodeRole: master                                        |
|  5. services           |    syncInterface: eth3                                     |
|  6. vpn                |    peerAddress: 10.0.99.2                                  |
|  7. security           |    sqliteSync:                                             |
| >8. ha                 |      enabled: true                                         |
|  9. storage            |      transport: mtls                                       |
| 10. k3s                |      requireSignedPayloads: true                           |
| 11. virt               |                                                            |
| 12. vigilante          |  [<Tab>] Switch Pane  [j/k] Domain  [<C-d>] Diff Drawer    |
|                        |  [<C-y>] YAML/Schema  [<C-s>/:AxonSave]  [:AxonApply]      |
+------------------------+------------------------------------------------------------+

Keybindings, Drawers & Ex Commands

  • <Tab>: Switch focus between left 12-domain sidebar and active editor pane
  • j / k (in sidebar): Navigate across the 12 canonical YAML domains
  • <C-d>: Toggle live structural unified diff drawer against committed state
  • <C-y>: Toggle compiled YAML / Zod schema reference drawer
  • <C-s> or :AxonSave: Validate schema and write domain file to /etc/axonwall/*.yaml
  • :AxonApply: Trigger axonwallctl apply with 120s Commit-Confirm safety

Direct Jump to Any of the 12 Domains

Open Directly to Any Canonical YAML Domain
bash
axonwall-config              # Interactive 12-domain workspace
axonwall-config system       # Capabilities, plugins, Eluvix, observability
axonwall-config interfaces   # Physical NICs, VLANs, bridges, bonds, VRFs
axonwall-config firewall     # Aliases, nftables rules, NAT, trafficShaper
axonwall-config routing      # Gateways, multi-WAN groups, static & FRR BGP/OSPF
axonwall-config services     # Kea DHCP, Unbound DNS/RPZ, HAProxy, FreeRADIUS
axonwall-config vpn          # WireGuard, PQ Rosenpass, IPsec, OpenVPN, Headscale
axonwall-config security     # Suricata, CrowdSec, GeoIP, SSO, hostDefense
axonwall-config ha           # 2-Host High Availability & Fleet Edge nodes
axonwall-config storage      # OpenZFS pools, datasets, SMB/NFS/iSCSI, S3 Vault
axonwall-config k3s          # K3s cluster, OpenEBS CSI, Vigilant Octo Waffle
axonwall-config virt         # KVM/QEMU VMs, LXC containers, VFIO, hostedEdge
axonwall-config vigilante    # Vigilante Autonomous SOC & SOAR

2. Standalone 11-Tab TUI & NastyMap Simulator (axonwall-tui)

Launch the standalone axonwall-tui binary to open Axonwall's real-time terminal cockpit across 11 top-level tabs, including the interactive NastyMap topology & dry-run packet path simulator:

11 Top-Level Tabs in axonwall-tui

[1] Dashboard & Live Throughput

[2] Interfaces, VLANs & Optical DOM

[3] Firewall Rules & Live Drops

[4] Routing, Gateways & BGP/OSPF

[5] Services & Post-Quantum Rosenpass ([g] keygen)

[6] High Availability & Sync Trust

[7] OpenZFS NAS Pools & Snapshots

[8] K3s Pods & KVM/LXC Guests

[9] NastyMap Topology & Packet Simulator

[u] ZFSBootMenu, Btrfs Snapper ([s]/[r]/[x]/[g]) & A/B Slots

[0] System, Plugins, GitOps & Ops

Launching axonwall-tui
bash
# Launch full interactive 11-tab cockpit
axonwall-tui

# Jump directly into Tab [9] NastyMap packet-path & topology simulator
axonwall-tui --nastymap

# Open a specific named tab or enforce read-only NOC observation mode
axonwall-tui --tab firewall
axonwall-tui --readonly

3. Complete axonwallctl Subcommand Reference

axonwallctl Control-Plane CLI Commands
bash
axonwallctl status                         # Daemon health, boot slot/BE, active roles, pending timer
axonwallctl validate                       # Lint all 12 /etc/axonwall/*.yaml files + nft -c dry-run
axonwallctl diff                           # Structural diff between /etc/axonwall/*.yaml and live state
sudo axonwallctl apply                     # Apply bundle with 120s Commit-Confirm auto-revert timer
sudo axonwallctl apply --no-confirm        # Apply and commit immediately (automation / CI pipelines)
sudo axonwallctl confirm                   # Confirm pending Commit-Confirm transaction before timeout
sudo axonwallctl rollback [revision]       # Roll back to previous or specific GitOps SHA revision
axonwallctl zbm <list|snapshot|clone|activate|delete|delete-snapshot>
sudo axonwall-btrfs-grub <sync|rollback N|create-snapshot>             # Btrfs + Snapper GRUB menu & atomic rollback
axonwallctl kernel detect [--json]         # Inventory CPU flags, IOMMU, TPM2, NVMe, NICs & lsmod
axonwallctl kernel audit [--json]          # Run 25-check KSPP + k3s + OpenZFS + nftables + eBPF audit
axonwallctl kernel config [--mode universal|stripped] [--output-dir <dir>]
sudo axonwallctl update [--btrfs] [--apt] [--version <ver>] [--slot <A|B>]
sudo axonwallctl plugin <list|enable|disable|install|remove|re-sync> <id>
axonwallctl kubeconfig [--vip]             # Export local or VRRP VIP-bound K3s ~/.kube/config
axonwallctl ebpf overview [--json]         # Dual-Stack VLAN XDP counters, SYN shield, BPF-LSM & BPF_TOKEN mounts
axonwallctl ebpf tokens [--json]           # Inspect /run/axonwall/bpffs-tokens/<profile> delegation mounts
axonwallctl ebpf xdp-blocks [--json]       # List active IPv4/IPv6 host & LPM CIDR TTL XDP_DROP entries
sudo axonwallctl ebpf xdp-drop <ip|cidr> [--ttl <sec>] [--reason <text>]
sudo axonwallctl ebpf xdp-unblock <ip|cidr>
sudo axonwallctl ebpf syn-limit [pps|off]  # Inspect or set Ring-0 TCP SYN-flood PPS rate limit (>= 100 PPS)
axonwallctl ebpf render-k3s [--profile networking-safe] [--namespace default] [--name <pod>]
axonwallctl harvester <status|episodes|simulate|export|ship> [--json]  # Blackbox Threat-LLM Harvester CLI
axonwallctl nas <status|snapshot|rollback|scrub|trim|checkpoint|unlock|lock> ...
axonwallctl virt <list|start|stop|reboot|snapshot|rollback|clone|migrate|xml> ...
axonwallctl k3s <status|etcd-snapshots|etcd-save|etcd-restore> ...
axonwallctl import <file> [--type auto|pfsense|opnsense|proxmox|truenas|...] [--merge] [--stage] [--apply]
axonwallctl mcp                            # Start stdio Model Context Protocol (MCP) 25-tool security server
axonwallctl cloudinit export --iso -o cidata.iso
axonwallctl config [domain]                # Launch Neovim Super Configurator on optional domain
axonwallctl edit <domain>                  # Edit raw /etc/axonwall/<domain>.yaml with schema check
axonwallctl export [--format json|yaml]    # Export merged DesiredState bundle
axonwallctl completion <zsh|bash|fish>     # Generate shell tab-completion script

4. ZSH Power-User Shell (cli-workstation)

Enabled by default on standard Axonwall editions, cli-workstation configures zsh with Oh My Zsh, syntax highlighting, autosuggestions, Tmux, bundled vim, neovim, kubectl, k9s (v0.51.0, bundled via core-k3s), & helm v3 (with automatic per-plugin PATH snippets covering opt-in bundled plugins such as cli-emacs / cli-emacs-doom / cli-emacs-spacemacs), tactical aliases (ax for axonwallctl, axc for axonwall-config, axt for axonwall-tui, k for kubectl, k9 for k9s), a custom Starship prompt that displays a flashing red COMMIT-CONFIRM (120s) badge whenever a rollback timer is pending, and complete tab-completions for axonwallctl, axonwall-config, axonwall-tui, kubectl, helm, zfs, zpool, virsh, nft, and wg.