The chat ​
orc chat is the front door: you say the work in plain words, and it turns your words into backlog commands. The chat is a Pi session with eight tools and no others, so it can change the backlog and nothing else.
flowchart TD you([You]) chat[orc chat<br/>the orchestrator model] tools[Eight tools, each one<br/>an orc command] backlog[(The backlog)] news[Closed tasks, questions,<br/>alerts and PR events] you -- say the work, answer,<br/>say merge --> chat chat --> tools tools --> backlog backlog -- read every 15 seconds --> news news -- posted to you --> chat
What the chat can do ​
Each tool runs one orc command, the same one you could type.
| Tool | What it does |
|---|---|
orc_backlog_add | Adds one task, with its kind, machine, parent, dependencies and priority |
orc_backlog | Reads the backlog, with every project, machine and task |
orc_backlog_hold | Holds a new task for your decision, with a reason and questions |
orc_backlog_priority | Sets or clears a new task's priority |
orc_backlog_edit | Replaces the title and the body of a new task |
orc_backlog_answer | Answers a held task, a parked task, a decision or a run waiting at its gate |
merge_task | Lands a closed task's pull request through orc merge |
orc_decision_board | Opens a local page with one card per open question |
The chat starts nothing itself. The beat starts the tasks, and a task the chat adds waits until it has a priority.
What the chat tells you ​
While it runs, the chat reads orc backlog --json every 15 seconds and posts what changed.
- Each task that closed, with its outcome, its reason and its pull request or report.
- Each held task and each parked question that waits on you.
- Each event the beat recorded: a stalled run, a pull request that turned green, merged or closed, and a split.
- Each alert the dashboard's alert stream fired.
Orc marks each close as posted in the task file. So a task that closed while no chat ran is posted by the next chat to start.
Your rules ​
When ~/.orc/orchestrator.md exists, the chat adds it to its system prompt as your rules. It also adds the instructions file of each project that names one. The decider reads the same files, so one set of rules steers both.
Decision boards ​
For a task with several open questions, the chat can open a decision board. The board is a local web page with one card per question, each with its options and the one the chat recommends. Each card you answer is recorded through orc backlog answer, word for word. The page has no login, so anyone on your network who holds the link can answer as you.