Skip to content

Rich TUI dashboard #7

@kortiene

Description

@kortiene

Context

claw status, claw inspect, claw doctor, claw policy explain each render a one-shot table. Operators running multiple agents need a live dashboard: agent state, recent audit events, drift status, resource usage, and pairing requests in one view.

Built on Rich's Live + Layout to stay aligned with the existing rendering stack.

Source: docs/SPRINT_PLAN.md §8.

Acceptance criteria

  • claw dashboard opens a full-screen TUI with three panes:
    • Top: agent table (name, status, image, drift, pairings, last audit).
    • Bottom-left: live audit tail (last 20 events, follows like tail -F).
    • Bottom-right: detail of the selected agent.
  • Arrow keys navigate the agent table; Enter pins detail; q quits.
  • Refreshes every 2s, or instantly on file change in ~/.claw/audit.jsonl.
  • Reads through the daemon socket (clawd daemon + local socket API #2) when available, falls back to direct file reads otherwise.
  • Works inside tmux and over SSH.

Out of scope

  • Mouse support.
  • Editing from the dashboard (start/stop/etc.) — read-only in v0.3, mutations stay on the CLI.

References

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or requestpriority/lowNice to havev0.3Targets the v0.3 release

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions