Use a project's board
Every project has a Board. It shows the project's tasks and its GitHub issues in six columns: Queued, Doing, Review, Blocked, Done and Dropped. Done and Dropped stay behind Finished until you open them.
Open it
- Web: open the project in Work, then choose Board.
- Mac: open the project, then choose Board on the TASKS header.
- iPhone and iPad: open the project, then choose Board in the pane picker.
The board reads the project again every 30 seconds while it is on screen, so a move an agent makes shows without a reload.
Move a card
- Mac and web: drag the card to another column.
- Every client: open the card's menu and choose Move to.
- iPhone and iPad: swipe a card to mark it Done.
A task's column is its status in Core. An issue's column is its state and
its agent:* label on GitHub. See
Labels the board reads.
Filter and hide columns
The filter menu has two parts.
- Held by: Anyone, People, Any agent, or one agent. An issue with an
agent:*label is the agent's. A task is a person's. - Columns: a switch for each column. Starlings keeps your choice for every project and every device. The board says how many cards sit in hidden columns. You cannot drop a card into a hidden column, but Move to still lists every column.
Hand a card to an agent
Open the card's menu and choose Hand off…. See Hand off a card to an agent.
Open the conversation
A card's last line is the last thing that happened to it. Choose it to open the project's Talk at that message.
Where it works
| Capability | macOS Host | macOS Join | Web | iOS / iPadOS | Agent access |
|---|---|---|---|---|---|
| Projects and leads, with their tasks and issues | Works | Works | Works | Works | search (MCP), open (MCP), task (MCP), record_decision (MCP), set_goal (MCP), starlings://subject/{kind}/{id}, starlings://subjects/{kind}, starlings://board/{days}, starlings://board/project/{id}/{days}, /api/crm/board, /api/crm/tasks, /api/crm/mine, /api/crm/recently-closed, /api/crm/unowned, /api/crm/goals, /api/crm/decisions, /api/crm/subjects, /api/crm/organizations |
Verified · docs/help/howto/use-a-project-board.md