PRD: TUI dashboard for fleet overview + command execution

[ric03uec]

Summary

Add a terminal UI (TUI) dashboard that presents a real-time fleet overview and allows users to run management commands without leaving the TUI.

Goals

• One-screen view of all instances, claws running per host, uptime, configured models, cost, agents, and high-level usage metrics
• Drill-down into a host and claw for more detail
• Run common management commands directly from the TUI (e.g., start/stop/upgrade/backup)

Requirements

• Fleet overview with live refresh
• Host detail view with list of claws and their status
• Claw detail view with config summary and recent activity/usage
• Command runner UI with confirmation prompts for destructive actions
• Keyboard-first navigation (no mouse required)
• Works over SSH and supports narrow terminals

Non-goals

• Full log viewer replacement (can link to existing CLI commands)
• Remote web UI (covered in separate PRD)

Acceptance Criteria

• TUI launches via a single clm subcommand
• Users can navigate between fleet → host → claw views
• Users can execute at least 5 core commands from the TUI
• Metrics shown match CLI output for the same targets

Notes

• Consider reuse of existing CLI/ansible runner plumbing for command execution
• Align metrics with cost and usage tracking conventions already in Clawrium

[ric03uec]

Triage Decision: enhancement, planning

PRD for new feature with clear goals, requirements, and acceptance criteria. Ready for planning.

---

Prompt Log

Stage: triage
Skill: /clm:triage
Timestamp: 2026-04-05T16:19:20Z
Model: z-ai/glm-5

Find and triage issues that don't have workflow labels.