pidash

pidash is a read-only terminal dashboard for Pi coding agents. It shows parent agents and their subagents in a tree, then shows session output for the selected row.

I made it after I started running several agents at once. The TUI was not giving me enough information on what my subagents were doing and often times it was impossible to tell if they were even working.

What it shows

• A live parent-and-subagent tree with conservative process-to-session matching
• Session output, errors, model details, task names, and token usage
• A smaller JSON snapshot for scripts and external dashboards
• Read-only inspection with no process-control path

Matching without guessing

pidash reads the process tree with sysinfo and scans Pi session files on disk. The difficult part is joining those sources. A process and a session do not always share a stable ID.

The matcher assigns exact working-directory matches first. It uses a fallback only when one unmatched process and one unused session remain. Subagent results follow the same rule: task, ID, or name must identify one result. If two matches are possible, pidash leaves them separate.

Ratatui and Crossterm draw the two-pane interface. The process scan and JSONL parser feed the same state model used by the terminal view and JSON output.

pidash never kills or controls an agent. Keeping it read-only makes the failure case simple: a bad match can affect what I see, but it cannot affect the work itself.