Skip to content

The App and the dashboard ​

Orc has two screens, a layout for the Herdr App and the orc-dash terminal dashboard, and neither holds any state of its own. Both only run the orc commands and draw what those commands print, so the screens and the command line never disagree.

flowchart TD
  files[(Files in ~/.orc<br/>and the pueue queues)]
  cli[orc backlog, orc runs,<br/>orc attention as JSON]
  dash[orc-dash snapshot]
  board[Board tab]
  agents[Agents tab]
  resources[Resources tab]
  drawer[Chat drawer<br/>runs orc chat]
  files --> cli
  files --> dash
  cli --> board
  cli --> agents
  dash --> resources
  drawer -- backlog commands --> files

The Board tab &ZeroWidthSpace;

The Board shows the backlog as cards in five lanes: Backlog, Planned, Awaiting you, Running and Done. Awaiting you gathers held tasks, parked questions, open attention items for you and closed tasks whose pull request is still open.

Board showing example garden tasks in five lanes

Selecting a card opens the task panel, with the task's whole conversation and its open questions to answer.

Task panel showing a held example task with one answered and one open question

The Agents tab &ZeroWidthSpace;

The Agents tab lists the runs and the queued tasks. For the selected run it shows each step, the agent's turns, and the changes on the branch.

Agents tab with a running run's Agent step in the Turns view and its Changes column

A run whose pull request waits for your word ends in an Approve step, which merges through orc merge.

Agents tab on the Approve step of a run whose PR waits

The Resources tab &ZeroWidthSpace;

The Resources tab shows each account's quota windows and each machine's cores, load, memory, disk and running orc runs.

Resources tab with example quota windows for two accounts and two machines

The chat drawer &ZeroWidthSpace;

Pressing cmd-k on any tab opens a drawer that runs orc chat. It is the same chat as in a terminal, with the same eight tools.

The terminal dashboard &ZeroWidthSpace;

orc-dash shows the same facts in a terminal, as panels for quota, session quota, resources, queues, schedules, dispatch, attention, tasks, alerts and ledger. It also watches quota pace, machine load and long tasks, and its alert stream is where the chat's alerts come from.