Skip to content
Starlings

Work

Projects, leads, partners and events, with their goals, tasks, issues, decisions, documents and the one conversation on each.

Where

ClientReach it
Mac⌘3; Mine is ⌥⌘3
iPhone and iPadThe Work tab
Web/work

Shape

When signed out on web, the page shows a centered card with the Work heading and one sign-in action.

On Mac and web the rail is a jump list: Overview, then SUBJECTS with Browse at its foot. INBOX and MINE are Overview's two columns, each with its filter beside its heading; on a wide window each column scrolls on its own. Quick Notes has a separate list below INBOX in that same scroll column, followed by Activity, and UNOWNED a separate list below MINE in its column. Every one of these headers folds: click its chevron to close or open the list; each device remembers its own folds. Web search is the shared ⌘K palette, opened from the header search button or the keyboard shortcut. On iPad the Work tab follows the Mac: a sidebar of Overview, then SUBJECTS with Browse at its foot, and Overview shows INBOX with Quick Notes below it in one column and MINE with UNOWNED below it in the other. On iPhone, and on an iPad in a narrow Split View, the Work tab is one list: Today, then INBOX, Quick Notes, Activity, MINE and UNOWNED as separate sections, then SUBJECTS. On every device INBOX, Quick Notes, MINE and UNOWNED stay separate lists; they are never merged into one. The column shows what you chose. The inspector shows the one item you chose inside the column. On Mac, the selected task, issue or Quick Note stays marked in its list while the inspector shows it.

A subject's views are one row of tabs under its name, on every client: Overview, then Talk (when it is not beside Overview), Board, Tasks, Issues, History, Documents and Fields, as the subject has them. A partner and an event lead with their own page. A subject's context groups (Team, Agents, Work, Relationship and About) sit beside its panes on Mac and web, and at the top of the subject overview on iOS. Choosing a person or agent opens their direct message in Team.

Mine and each subject's Tasks pane list open tasks. Recently finished keeps your completed or cancelled tasks and closed GitHub issues from the last seven days, newest first. Choose it in Mine's filter menu, under Due, on every client: it replaces the open list until you choose another Due option or Reset. Choose Reopen to put one back into open work. Home's QUICK ACCESS module is what you opened, not what you completed. To find older closed GitHub issues, open a project's Issues pane and set State to Closed; Order can sort by Recently updated.

On Mac, the Work tab includes the open subject or direct item in its title, such as Work — Project name; returning to Overview clears the item title.

When filing a Quick Note, the destination picker searches as you type. It searches projects and leads beyond the first page, and filters the conversation list in place. The choices stay cached for five minutes and clear when their source lists change or the owner signs out.

A new lead requires an organization. A project may have one or none. Search the workspace's organizations in the Organization picker on Mac, iPhone/iPad or web; when no exact match exists, create the organization from that picker. In the same sheet, the Contact picker puts one contact on a lead and the Contacts picker puts several on a project. Both search the workspace's contacts on Mac, iPhone/iPad and web, with or without Core.

An organization's page lists its people under CONTACTS. Add contact (the + beside it on Mac and web, the row under them on iPhone and iPad) adds one to that organization: a name, a title, the organization, and addresses, one per line with the primary first. A contact opens on their own page (in the inspector on Mac, pushed on iPhone and iPad, /work/contact/<id> on the web): their addresses, the projects and leads they are on, the calls they were in and the members who met them. Edit changes any of it. Search finds a contact by name, organization or address. One address belongs to one contact; an address that is already another contact's is refused.

On the web, Browse is in sections: Work (projects, client projects, leads and events), Commercial (offers, licenses and the catalog) and Directory (organizations and contacts). Each section folds, and each device remembers its folds. The web sidebar lists projects, leads and events; star an organization to keep it there.

Browse → CONTACTS lists every contact, after the organizations. Search finds a contact by name, address, title or organization. The filter menu narrows the list by organization, country, partner, existing client, Signals status and language. Each device remembers its own filter.

A contact's page has Edit, Merge… and Delete, on the web, the Mac and the iPhone. Edit also sets the birthday, the language, the Signals status and the characteristics. A new contact needs no source. Merge… takes a duplicate contact: the older one stays and keeps every link and address, and the other is deleted. Delete asks first. It is refused while a call or a task still names the contact, and the refusal names them. Its leads and projects stay, without the contact.

An organization's page has Edit organization, Merge… and Delete, on the web, the Mac and the iPhone. Edit organization changes its name, website, industry, legal name, city, country, LinkedIn, domain and notes, and the Partner, Agency and Existing client flags. Merge… takes a duplicate organization: the older of the two stays and keeps every link, and the other is deleted. Delete asks first, and is refused while a project, lead, contact or task still points at the organization; the refusal names them.

In Mac Browse, leads use the same openable subject rows as projects, with the organization logo when available and a lead icon when one is not on file.

A won or lost lead is closed. Browse, SUBJECTS, the lead pickers and the lead counts show open leads; pick All, Closed Won or Closed Lost in Browse's status filter to see the closed ones. A closed lead still opens from a link and from its project's Won from.

Browse → EVENTS lists upcoming events. Each row shows the days remaining, or Today when the event is today.

The same searchable picker is used for long subject, assignee, owner and goal choices in Work task and goal forms, and Mac's board filters. Calendar source choices in the event editor use it on all three clients. Web CMS relation and time-zone fields use it too. Each list keeps its existing order; short fixed choices such as status and responsibility stay compact.

DestinationHolds
OverviewToday's meetings, INBOX above Quick Notes in one column, and MINE beside them; the column with nothing chosen. On Mac, a task or issue from either list, or a Quick Note or document, opens in the right inspector and keeps the lists visible
INBOXWhat is new and waits on you; each row leaves when resolved. It has two groups. Answer comes first: rows where someone waits on your reply or your decision. To file comes under it, with its own number and a header that folds: Quick Notes, sales touches, bookings, events from email, interest and form submissions, things that came in with no home yet. The INBOX count, on every badge and on Home, counts the Answer group only. Unread talk is not a row: it is the dot on the subject, and a conversation that names you is a row. Your own overdue and assigned work is never here: MINE lists it. Decisions an agent asked you name their sender and come first, overdue first, and leave a week after their default-by day if nobody answers ([Answer a decision](../howto/answer-a-decision.md)). A card you handed to an agent is a row when the agent moves it to Review or Blocked, and leaves when the card moves on. The row opens the card. After a call you hosted with people from outside your team, the drafted follow-up and the call's tasks are a row too ([Send a follow-up after a call](../howto/send-a-follow-up-after-a-call.md)). A call that is not filed on a lead, project or partner puts its tasks here as proposed rows for every member; a row opens the task, where Accept or Decline settles it. A guest or an organization who wrote on a subject you can see, and got no answer yet, is a row until someone replies or you dismiss it; it opens that subject's Talk. A message from an app user or a public contact opens its conversation in Team, on Mac, iOS and web. When Starlings support answers a question you asked in Help, the Help button shows it
ActivityThe latest 30 interactions and quiet event lines from the past seven days on your visible, unmuted open projects and events, plus leads with Sales on. Expanded by default; each row opens its subject at History. An entry on a subject with unread talk carries the same unread dot as the subject's row; reading the conversation clears it. It never adds to INBOX counts. Partial history keeps the available rows and offers Retry
Quick NotesCaptured notes without a subject, in their own list below INBOX. File… or delete a note here
MINEWhat you owe, by when. Every row says when: Overdue with its date, Today, a date, No date, or Unfiled; a started task adds its stage. Complete a task from its row: it starts fading out immediately on the web and iPhone/iPad, while Mac shows its completed mark. Right-click a task (long-press on the phone) for Done, Cancel Task or Hand off to an agent, and an issue for Close issue, Close as not planned, Reopen issue or Hand off. A failed write restores the task. The same menu is on every list that shows them
UNOWNEDOpen work on any open subject that nobody on the workspace's side holds: a task with no assignee that the client does not owe, and a GitHub issue with no assignee and no agent:* stage label. Same order and rows as MINE; its filter menu shows Tasks (the default), GitHub issues or All work, then Subjects: one checkmark per subject with unowned work of that type; uncheck one to hide its rows, and Show all subjects brings them back. Both are remembered on each device. A row you complete, cancel, close or assign leaves the list at once. Right-click a row (long-press on the phone) and choose Assign to ▸ a teammate (you are first, as Me): a task becomes theirs on the workspace's side, an issue gets their GitHub username as its assignee (teammates with no GitHub username cannot take an issue). Shown only when there is something in it, and a row leaves the list once someone holds it
Recently finishedA choice in MINE's filter menu: your own recently completed or cancelled tasks and closed issues, in place of the open list; Reopen puts the row back into open work
SUBJECTSEvery open subject, starred first, the ones with new talk first
A subjectIts Overview: Talk beside Goals / Tasks / Issues / Decisions / Documents / History; metadata in the inspector, and Fields as a tab. A lead that came from a form shows the form's answers first, every question with what the person wrote. Context groups fold independently; choosing someone in Team or Agents opens their direct message. On a project or lead, Team lists first the person who answers for it, marked Responsible, or Responsible (suggested) when nobody chose and the open tasks point to someone; a person row's menu has Make responsible. It names who answers, and changes nobody's access. On the web, decisions head History
A taskIts page: status, due date, subject, who is responsible and who holds it, then Activity, everything said about the task in the threads you can read. That is the hand-off with what done looks like, the agent's steps and answers, its questions, and the event lines. Answer an agent's question here, in Inbox or in Talk: one answer clears all three. On the web, Open in Talk shows a line in its conversation. On the Mac it is in the task's inspector, on iPhone and iPad at the foot of the task
FieldsEvery field of a project or lead. Change what you need, then Save; Revert drops the draft. On the Mac and the phone the pane reads and writes through Starlings, on any workspace: the title, status, dates, URL, description, the Internal switch and a lead's notes and qualification checklist, and the project notes and EVID where Project specs is on. The organization, lead and contacts show as names and change in Edit details…; a partner's fields are read-only. On the web, the pane lists every field the registry has: text, numbers, dates, toggles and choices edit in place; relations, lists, countries and industries show read-only. An event's fields are its Event page
SalesAn optional section inside Work for leads; switched on in Settings → Work
Offers and LicensesTwo groups on Browse. Filter offers by status and licenses by product and status. Pick Signals to see the Signals customers. Web and Mac open and edit a row, and iPhone and Android open it to read. A license can also be created from the Licenses group on an organization or a lead. An offer lists who viewed it: when, and by which address

Controls

ControlDoesShortcut
New Project… / New Lead… / New Document / New Quick Note…The + menu; a new lead requires an organization, and a project may have one, searchable or created from the picker—
Edit details…Update a project's organization, contacts, name, status, dates, URL and descriptionproject menu on Mac; subject menu on iPhone and iPad
Edit organization / DeleteChange an organization's fields, or delete it once nothing points at itthe organization's page on web
Win…On an open lead: start its project with the lead's organization, contact and title, move the open tasks you pick, and close the lead as won. The new project opens. The project shows the lead under Won from, the lead lists it under Projects, and the project's History includes the lead's calls, meetings and notes, marked From the leadlead row menu on Mac, iPhone, iPad and web; the lead's header menu on web
New TaskA task on the open subject; on a project it names the goal it serves⌥⌘T; ⌘N in Work
LogA call, meeting or note on the open subject's History, with its type, title, date and time, summary, link, organization, lead, project and contacts. A project fills in its project and organization, a lead its lead and organization, a partner itselfHistory header on Mac and web; the + on History on iPhone and iPad; the + on Overview's History group on web
Edit / Delete…Change a History row in the same editor, or delete it after you confirm. Starlings refuses a row you cannot changethe History row's reader; the inspector on Mac
New GoalA goal on the open project: title, target date, owner. A goal row settles as Met or Dropped, and reopensOverview header +
Record DecisionA decision on the open subject, citing a live goal when there is one. Written once. Starlings posts a line about it in the channelOverview header +
Open decisionA decision in INBOX: the sender, context and links, and a button per option with the recommended one marked. Choose one to answer, with an optional note; on the Mac, press Answer to send the selection. The row's menu lists each option as Answer: …decision row menu
Mark as DecisionThe channel line, verbatim, becomes a decision on the subjectline menu
More actionsOn a Talk message: reply, react (including to your own), copy, mark as a decision, save your own text as a Quick Note copy, or edit and withdraw your own messagemessage menu
Save as Quick NoteCopies your message text into your private Quick Notes list; the original stays in Talk. Use File… on the copy to triage it into shared workyour message menu
Submit answerSends the selected options for a multiple-select question. A single choice is sent when selected. Questions gather information; they do not approve an actioninteractive question
New IssueAn issue on the open subject's repository⌥⌘I
New DocumentA document filed on the open subject⌥⌘D
Float DocumentThe document open in the inspector, in a window of its own that stays on top (Mac)⇧⌘F
Meet about thisOpens your room with the subject attached, so the record files there—
MessageOpens a person's or agent's direct message in Team from the subject contextperson row
OverviewBack to the lounge⌥⌘0
Back / ForwardThrough what you opened⌘[ / ⌘]
Show Right Sidebar / Hide Right SidebarShow or hide the selected item's context panel; the web defaults to closed and remembers an open panel per surfaceheader on web; toolbar on Mac
BoardA project's tasks and issues by stage. Drag a card to another column, or use its menu to move it or hand it off. The filter picks who holds the cards shown and which columns you hide; hidden columns follow you to every devicea project's Board tab; on Mac, also Board on the project's TASKS header
SearchMac: Subjects and Docs with this window's scope; web: global search. Type in a searchable picker to narrow its list. File Quick Note searches projects and leads beyond the first page⌘F on Mac; ⌘K on web
FiltersNarrow the open task or issue list by its available facetslist header
StateShow Open, Closed or All GitHub issues; ordering is a separate choicea project's Issues pane
BrowseIts foot row, Other records: records with no subject page, read and edited in place. Search them by name, or open a table your account can list. Mac, iPhone and Android open it from the foot of Browse; the web finds these tables and records in Search and opens each on its own pageThe foot of Browse
Keep vaultMac and iPhone: opens the project's vault in Keep. Web: says to open it on Mac or iPhone, with the download links; a browser never holds vault keys and the web shows no vault materialproject menu
File on GitHubTurns a task into an issue on the linked repository, from the task rowrow menu
Star / UnstarKeeps a CRM/CMS subject, task or issue in Home's QUICK ACCESS list; subject stars also lift it to the top of SUBJECTSrow menu; a top-left star badge marks starred rows
Hand off to %@Gives a card to an agent: use the menu of a card or of any task or issue row, or drop it on the agent in the sidebar (Mac). Starlings posts it in the subject's Talk with the agent's @mention. The card then moves itself: Doing when the agent starts, Blocked when it asks you something, Review when it answersdrag, or the row or card menu

Row menus (web)

Every Work row you can act on has a menu. Open it with the … on the row, a right-click, or ⇧F10. The … shows when the pointer is over the row or the row has focus; on a touch screen it is always there. A top-left star badge marks a starred row; Star / Unstar stays in the row menu. The groups and their order come from one registry across the clients; each client omits actions it cannot perform. The Mac marks destructive actions in red.

RowMenu
A subject, in SUBJECTS and BrowseStar, Mute / Open, Edit details…, Win… (an open lead) / Open tasks, Open issues, New task, New issue / Keep vault (a project), Open full record. A partner: Star, Mute / Open, Open talk, Open history / Open tasks, New task / Open full record
A task, in MINE, INBOX and a subject's TasksDone, Cancel task / its door / File on GitHub / Open full record / Star. A proposed task: Accept, Decline / its door / Open full record
An issue, in MINE and a subject's IssuesClose issue, Close as not planned, or Reopen issue / Open full record / Star
INBOX: a mentionOpen the subject / Mark as read, Mute / Open full record
Quick NotesFile… / Delete
INBOX: a sales touchStart a lead… / Dismiss, Copy contact email
INBOX: a document commentOpen document, Open the subject / Resolve / Open full record
INBOX: agent work to checkOpen / Open the subject, Open on GitHub (an issue)
INBOX: a follow-upOpen / Dismiss
INBOX: a bookingOpen in Calendar, Copy contact email / Dismiss
INBOX: a calendar invitationAccept, Maybe, Decline / Open in Calendar
INBOX: an event from forwarded mail (where your workspace takes mail)Add to calendar, Discard
INBOX: interestCopy contact email / Dismiss. The row itself opens the lead the request filed
INBOX: form submissionCopy contact email / Dismiss. The row itself opens the lead the submission filed
A goalMet, Drop; or Reopen

The web leaves out what it cannot do yet: Rename… on a subject, Meet about this and Link GitHub repository…. Keep vault on the web is a handoff to Mac and iPhone, never a vault. A decision row has no menu, as on the Mac.

Task and issue lists share one native filter scope: status and search stay visible, facet choices open from Filters, and sorting remains separate. Task facets are responsible party, assignee and due date; issue facets are labels, assignee and milestone. On the web, you can read details and activity, and take the same actions with repository pickers. A direct task link opens that task's details; Edit task opens its editor.

On Free, a second project is refused with "Free includes one project." An admin also sees Upgrade, which opens the pricing page; anybody else reads "Ask an admin to upgrade." A project the plan holds read-only says so at the top, on the Mac, the iPhone and the web, and refuses every write.

Leads to

A subject's Talk is the conversation on it; a person in it opens team. A document opens in docs.

A chip under a line in Talk opens what the line is about, and reads as a link when it does: a task or an issue opens in place; a decision opens History and a goal opens Tasks (both open Overview on iPhone and iPad); a pull request, commit, CI run or release opens on GitHub. A meeting's chip is a label.

The attention queue and Inbox

The attention queue is the set of pending questions and decisions assigned to you. Inbox shows those requests alongside other things that need attention, such as unread conversations and document comments. MINE remains the work you owe; Activity remains recent history.

An assigned question is the same request in chat, Home Inbox and Work INBOX. Answering or dismissing it in one connected view resolves it in the others. Opening it, reading its conversation or closing the question dialog leaves it pending. A notification points you to it; clearing a notification is not an answer. Answering a question supplies information and does not approve an action. On Mac and iOS, Inbox answers it; their chat controls do not yet refresh from the same request (meet#774).

For the full behavior and current coverage, see [User attention](../../USER_ATTENTION.md). This term describes the comms logic; the controls retain their existing names.

Assigned agent questions

On Mac, iOS and web, assigned questions appear in Home's Inbox card and Work INBOX, with the sender and conversation/subject context. Open the row to choose one option immediately, select several and press Submit answer, or explicitly Dismiss. Answering or dismissing closes the same request in the web chat on refresh. Another participant sees who the question is waiting on. A read or closing the dialog leaves the question open. See [Answer a question](../howto/answer-a-question.md).

Mac and iOS also answer/dismiss from their canonical Inbox detail. Their inline chat controls still infer outcomes from source replies; canonical native chat refresh remains in meet#774. Notification coordination remains in meet#775; leaving a chat does not create a new alert in this UX slice.

Offers

With Offers on, a lead's or an organization's Overview has an Offers group, and Catalog sits at the top of Work's rail on the web and the Mac. On iPhone and Android an Offers row opens the offer to read, share, duplicate and record. See [Write an offer](/help/howto/write-an-offer).

Where it works

CapabilitymacOS HostmacOS JoinWebiOS / iPadOSAgent access
Answer agent questions from InboxPartialPartialWorksPartialHuman only: Only the assigned human recipient can answer or dismiss their request.
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
Channels on the work itselfWorksWorksWorksWorkssend_message (MCP), starlings://thread/{id}
Interaction history on a project, lead or organizationWorksWorksWorksWorksstarlings://feed/{limit}, /api/crm/feed, /api/crm/interactions
Meet about a project or leadWorksNot availableNot availableWorksPlanned
Read a task directly from MineWorksWorksWorksWorksopen (MCP), task (MCP), /api/crm/mine
Goals on a project, decisions on any subjectWorksWorksWorksWorkssearch (MCP), open (MCP), record_decision (MCP), set_goal (MCP), task (MCP), transcript (MCP), starlings://subject/{kind}/{id}, /api/crm/goals, /api/crm/decisions
Interactive questions in agent conversationsPartialPartialWorksPartialHMAC callback: /api/internal/channel-events
A queue of decisions waiting on youWorksWorksWorksWorksask_decision (MCP), now (MCP), open (MCP), starlings://subject/{kind}/{id}, /api/decision-asks

Verified · docs/help/surfaces/work.md