Admin Panel

clawdie-admin is a lightweight terminal UI for managing Clawdie on the Lumina desktop. It uses pure shell + bsddialog — no external GUI toolkits.

Entry Points

• Lumina panel applet — right-click system tray → “Clawdie Admin”
• CLI — clawdie-admin opens the interactive menu
• Desktop launcher — double-click ~/.local/share/applications/clawdie-admin.desktop

Capabilities

Area	Actions
Clawdie service	Start, stop, view status and PID
Jails	List, start, stop, open console (jexec)
ZFS snapshots	Create, list, restore
System health	CPU load, RAM usage, disk usage, pool status
Logs	Tail service and jail logs
Configuration	Change assistant name, timezone, LLM provider
Operator account	(planned) Set dashboard credentials post-install — wraps npm run set-operator
Hardware	Audio card detection, network interfaces, USB devices

Quick Status Display

The main menu shows a live summary:

• Clawdie service status (running/stopped, PID)
• ZFS pool usage
• Memory usage
• CPU load (1-min average)
• Audio device status
• Network interface status

Architecture

The admin panel runs as a host-level tool — it is not jailed. It needs access to:

• service clawdie status — service control
• bastille list — jail listing
• zfs list/scan — snapshot management
• sysctl — hardware and load info

All privileged operations use sudo (not doas).

Source

The admin panel is built as part of the Clawdie ISO image. See clawdie-iso/ADMIN-PANEL.md for full implementation details.