# Help

> How Starlings works: one page per surface, one page per task.

## How Starlings works

One page per surface and one page per task. Agents read the same pages.

### Surfaces

- [Admin](https://starlingshq.com/help/surfaces/admin): Admin: the org in six groups with a page per topic, opening on People; admins only
- [Calendar](https://starlingshq.com/help/surfaces/calendar): Calendar: Google, EventKit and subscriptions, one week or day or month; ⌘2; `/calendar`
- [Docs](https://starlingshq.com/help/surfaces/docs): Docs: the whole corpus, with a linked graph view; save links and articles from iOS, Mac and the browser; ⌘5; `/docs`
- [Ended](https://starlingshq.com/help/surfaces/ended): Ended: the meeting is over, how long it lasted, why it ended
- [Home](https://starlingshq.com/help/surfaces/home): Home: the clock, the modules in your order, and your room. ⌘1; the first tab; `/`
- [Meeting](https://starlingshq.com/help/surfaces/meeting): Meeting: the stage, the rail and the control row while a call is live
- [Prejoin](https://starlingshq.com/help/surfaces/prejoin): Prejoin: before you join, the camera and microphone check, then Ask to join
- [Room entry](https://starlingshq.com/help/surfaces/room-entry): Room entry: a guest at `/room/<slug>`, with a name, an email and two doors
- [Schedule](https://starlingshq.com/help/surfaces/schedule): Schedule: `/book/<slug>`, pick a time, say who you are
- [Search](https://starlingshq.com/help/surfaces/search): Search: the ⌘K palette, one box that finds anything and jumps anywhere
- [Settings](https://starlingshq.com/help/surfaces/settings): Settings: account, room policy, calendar, audio, video, captions, Home layout, Inbox sources; ⌘,; `/settings`
- [Team](https://starlingshq.com/help/surfaces/team): Team: who in the workspace is around, and reaching them; ⌘4; `/team`
- [Waiting room](https://starlingshq.com/help/surfaces/waiting-room): Waiting room: the knock is sent; the host decides
- [Work](https://starlingshq.com/help/surfaces/work): Work: every subject, what needs you, what you owe; ⌘3; `/work`

### How to

- [Answer a calendar invitation](https://starlingshq.com/help/howto/answer-a-calendar-invitation): Accept, Maybe or Decline a Google Calendar invitation from the Inbox on Mac, iPhone and web
- [Answer a decision](https://starlingshq.com/help/howto/answer-a-decision): Answer the decisions an agent put to you, from INBOX on any client; how an agent asks and reads the answer
- [Answer a question](https://starlingshq.com/help/howto/answer-a-question): Answer or dismiss an assigned agent question from Home or Work Inbox on Mac, iOS and web
- [Book a time](https://starlingshq.com/help/howto/book-a-time): Find a time with a member at `/book/<slug>`
- [Call a colleague](https://starlingshq.com/help/howto/call-a-colleague): Wave for attention, or Call into their room
- [Connect a repository](https://starlingshq.com/help/howto/connect-a-repository): Map a GitHub repository to a project at `/admin/connectors/github`
- [Connect an agent as a Team member](https://starlingshq.com/help/howto/connect-an-agent-as-a-team-member): Put 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 MCP](https://starlingshq.com/help/howto/connect-an-agent-over-mcp): Pair any MCP client (Claude, Hermes or your own agent) with Starlings at `/mcp`, acting as you
- [Connect Claude](https://starlingshq.com/help/howto/connect-claude): Pair a Claude with Starlings over MCP at `/connect`
- [File a task on GitHub](https://starlingshq.com/help/howto/file-a-task-on-github): Turn a task into an issue on the subject's repository
- [Forward an email](https://starlingshq.com/help/howto/forward-an-email): Forward 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 agent](https://starlingshq.com/help/howto/hand-off-a-card-to-an-agent): Give a task or an issue to an agent from Work
- [Host a meeting](https://starlingshq.com/help/howto/host-a-meeting): Open your room, admit who knocks, end it; from the Mac, the phone, or the CLI
- [Join a room](https://starlingshq.com/help/howto/join-a-room): Enter a room as a guest: the link, your name and email, the check, the knock
- [Labels the board reads](https://starlingshq.com/help/howto/labels-the-board-reads): Which GitHub labels move a card on the Work board, and which are inert
- [Message a colleague](https://starlingshq.com/help/howto/message-a-colleague): Send a message, start a group, or reach Everyone from Team
- [Read a meeting transcript](https://starlingshq.com/help/howto/read-a-meeting-transcript): Find the transcript and notes of a meeting that ended
- [Read project status](https://starlingshq.com/help/howto/read-project-status): Have 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 subject](https://starlingshq.com/help/howto/remove-a-channel-without-a-subject): Remove a channel whose project, lead, partner or event was deleted from the workspace, and put it back (admins)
- [Run an event sign-up](https://starlingshq.com/help/howto/run-an-event-sign-up): Let 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 browser](https://starlingshq.com/help/howto/save-a-page-from-your-browser): Save any web page to Docs from your browser or from Safari on iPhone, article included
- [Send a follow-up after a call](https://starlingshq.com/help/howto/send-a-follow-up-after-a-call): After 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 workspace](https://starlingshq.com/help/howto/set-up-your-workspace): Set up a new workspace as its first admin: the steps on Home, on the Mac, iPhone and web, and what ticks each one
- [Switch workspaces](https://starlingshq.com/help/howto/switch-workspaces): Sign 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 board](https://starlingshq.com/help/howto/use-a-project-board): See a project's tasks and issues by stage, move them, filter them, and hide the columns you do not use
- [Write an offer](https://starlingshq.com/help/howto/write-an-offer): Write an offer on a lead or an organization, send it, change it after sending, and record the buyer's answer

### Words

[Glossary](https://starlingshq.com/help/glossary): what each word means in Starlings, with its source.

### For agents

[/llms.txt](https://starlingshq.com/llms.txt) is this index; [/llms-full.txt](https://starlingshq.com/llms-full.txt) is every page. A member's Claude connects at `/mcp` on their workspace host.

---

Canonical page: https://starlingshq.com/help
