How Starlings works
One page per surface and one page per task. Agents read the same pages.
Surfaces
- AdminAdmin: the org in six groups with a page per topic, opening on People; admins only
- CalendarCalendar: Google, EventKit and subscriptions, one week or day or month; ⌘2; `/calendar`
- DocsDocs: the whole corpus, with a linked graph view; save links and articles from iOS, Mac and the browser; ⌘5; `/docs`
- EndedEnded: the meeting is over, how long it lasted, why it ended
- HomeHome: the clock, the modules in your order, and your room. ⌘1; the first tab; `/`
- MeetingMeeting: the stage, the rail and the control row while a call is live
- PrejoinPrejoin: before you join, the camera and microphone check, then Ask to join
- Room entryRoom entry: a guest at `/room/<slug>`, with a name, an email and two doors
- ScheduleSchedule: `/book/<slug>`, pick a time, say who you are
- SearchSearch: the ⌘K palette, one box that finds anything and jumps anywhere
- SettingsSettings: account, room policy, calendar, audio, video, captions, Home layout, Inbox sources; ⌘,; `/settings`
- TeamTeam: who in the workspace is around, and reaching them; ⌘4; `/team`
- Waiting roomWaiting room: the knock is sent; the host decides
- WorkWork: every subject, what needs you, what you owe; ⌘3; `/work`
How to
- Answer a calendar invitationAccept, Maybe or Decline a Google Calendar invitation from the Inbox on Mac, iPhone and web
- Answer a decisionAnswer the decisions an agent put to you, from INBOX on any client; how an agent asks and reads the answer
- Answer a questionAnswer or dismiss an assigned agent question from Home or Work Inbox on Mac, iOS and web
- Book a timeFind a time with a member at `/book/<slug>`
- Call a colleagueWave for attention, or Call into their room
- Connect a repositoryMap a GitHub repository to a project at `/admin/connectors/github`
- Connect an agent as a Team memberPut any agent runtime in a workspace's Team: it enrolls itself, an admin approves the code, it collects its own keys
- Connect an agent over MCPPair any MCP client (Claude, Hermes or your own agent) with Starlings at `/mcp`, acting as you
- Connect ClaudePair a Claude with Starlings over MCP at `/connect`
- File a task on GitHubTurn a task into an issue on the subject's repository
- Forward an emailForward an email into a project's channel, or to calendar@ to add the events it describes, from any mail app
- Hand off a card to an agentGive a task or an issue to an agent from Work
- Host a meetingOpen your room, admit who knocks, end it; from the Mac, the phone, or the CLI
- Join a roomEnter a room as a guest: the link, your name and email, the check, the knock
- Labels the board readsWhich GitHub labels move a card on the Work board, and which are inert
- Message a colleagueSend a message, start a group, or reach Everyone from Team
- Read a meeting transcriptFind the transcript and notes of a meeting that ended
- Read project statusHave an agent answer where a project stands: which read to make, the six stage words, and what a status is not
- Remove a channel without a subjectRemove a channel whose project, lead, partner or event was deleted from the workspace, and put it back (admins)
- Run an event sign-upLet people sign up for an event at `/event/<slug>`, let them in with their own link, and send the follow-up
- Save a page from your browserSave any web page to Docs from your browser or from Safari on iPhone, article included
- Send a follow-up after a callAfter a call with people from outside your team, approve the drafted follow-up and its tasks from Inbox; your mail app sends it
- Set up your workspaceSet up a new workspace as its first admin: the steps on Home, on the Mac, iPhone and web, and what ticks each one
- Switch workspacesSign in from the list of your workspaces, add one by its address, switch, and sign out of or remove one on the Mac, iPhone or web
- Use a project's boardSee a project's tasks and issues by stage, move them, filter them, and hide the columns you do not use
- Write an offerWrite an offer on a lead or an organization, send it, change it after sending, and record the buyer's answer
Words
Glossary: what each word means in Starlings, with its source.
For agents
/llms.txt is this index; /llms-full.txt is every page. A member's Claude connects at /mcp on their workspace host.