clawdie/colibri
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 47
colibri/docs/guide/architecture/admin-panel.md
Sam & Claude 95c487546d
Some checks failed
CI / rust (pull_request) Has been cancelled
Details
CI / markdown (pull_request) Has been cancelled
Details
CI / port (pull_request) Has been cancelled
Details
CI / agent-jail-pkgs (pull_request) Has been cancelled
Details
docs(guide): port 39 procedural docs from clawdie-ai to colibri 
New docs/guide/ tree — canonical home for operator-facing procedural docs.
Starlight frontmatter added to all files. 0.12 alignment fixes applied:

- v0.11.0 → v0.12.0 throughout
- PI_TUI_PROVIDER/MODEL → DEEPSEEK_API_KEY
- Headless Codex login → Agent runtime setup (zot + RPC mode)
- /login and auth.json references removed
- pi → zot in provider-fallback spawn reference
- colibri-provider-verify (was pi-provider-smoke)
- Language cleanup: smoke test → verification, fake → test,
  can't self-fix → requires operator intervention,
  broken → unresponsive, Fix anything broken → Verify all checks pass

Two-tree model: docs/wiki/ (decisions) + docs/guide/ (procedural).
Single source of truth in colibri. clawdie-ai docs/public/ to be retired.
2026-06-26 09:16:43 +02:00

2.2 KiB
Raw Permalink Blame History

title description
Admin Panel bsddialog-based system management UI for Clawdie on FreeBSD.

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.