Skip to content
Starlings

Read project status

An agent paired over MCP, such as Claude or Hermes, can answer "where does this stand" without you opening Work. Ask it plainly, or use the project_status prompt. To pair one, see Connect an agent over MCP.

Status is a read of the subject. The record of the tools an agent called shows who looked. It does not show where the work stands.

Which read answers which question

AskThe agent reads
Everything open, at oncestarlings://board/<days>: every open subject with its open tasks and issues, plus what finished in the last <days> (1 to 90)
One subjectsearch, then open on that row's door: recent interactions, open tasks, open issues
One project's cards by stagestarlings://board/project/<id>/<days>: the project's tasks and issues, the read its Board makes, plus what finished in the last <days> (1 to 90)
One subject, with goalsstarlings://subject/<kind>/<id>, where kind is lead, project, partner or event
What changed latelystarlings://feed/<limit>: interactions, newest first, 1 to 100
Which subjects are busystarlings://subjects/<kind>: open-task counts and last activity
Todaynow: people around, the next 24 hours, your tasks and issues, quick notes
A meeting's transcripttranscript, on a meeting link from an interaction

The brief prompt makes the one-subject read for you. The prep_next_meeting prompt makes the read before a call.

The six stages

A stage is one of queued, doing, review, blocked, done, dropped. No other stage exists. Starlings computes the stage from the row and never stores it. "In progress" and "waiting" are the agent's words, not stages. An open issue with no agent:* label is queued. This does not mean that anyone has started.

What a status read does not do

  • It does not write. task, record_decision and set_goal change the thing you asked about. A Claude answering a status question should ask before touching any of them.
  • It does not post to Talk. Reads leave no line in a subject's Talk. Only writes do.
  • It is not the call record. Every read adds a row that you can see under Settings → Account → Connected agents. That row shows that the agent looked. It does not answer the status question.

Where it works

CapabilitymacOS HostmacOS JoinWebiOS / iPadOSAgent access
Projects and leads, with their tasks and issuesWorksWorksWorksWorkssearch (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
Issues that read like GitHub's ownWorksWorksPartialWorkscreate_issue (MCP), /api/crm/issue
Interaction history on a project, lead or organizationWorksWorksWorksWorksstarlings://feed/{limit}, /api/crm/feed, /api/crm/interactions
An agent starts a meetingHaveNot availableNot availableNot availableNot availablestart_meeting (MCP), schedule (MCP), starlings host

Verified · docs/help/howto/read-project-status.md