Project Overview
The Overview is where a project opens, and the first item in its navigation on a desktop and on a phone. It answers “what needs me, and what is going on here?” in one screen, and lets you start more work from the bottom of the page.
Chat is one tap away: Chat in the project navigation on a desktop, or the Chat button at the right of the app bar on a phone. Links that point at one chat (a notification about a chat, Open chat on an inbox item or a receipt, a row in Running now) still open that chat directly.
Layout
Section titled “Layout”- On a phone, top to bottom: Needs you, the brief folded to one line, Running now, This week, Budgets, Automations and Recently, with the task box pinned at the bottom.
- On a desktop: the brief and Needs you on the left with the task box under them, and the other sections in a column on the right.
What it shows
Section titled “What it shows”The brief
Section titled “The brief”A few generated sentences on how the project is advancing and what is in the way, most important first: what is waiting on a person, what is failing or stuck, then what moved. Every item it mentions (an inbox item, a chat, an automation, an account, a pull request or an idea) is a link to that item. It never contains numbers: the counts are on the sections below it.
- On a phone it is one line under Needs you. Tap the arrow to read the first two sentences in place. On a desktop it shows up to three sentences above Needs you.
- It is written from what every member of the project can see: open inbox items addressed to the whole team (or, in a one-person project, to you), running and recently failed chats, failing automations, shared accounts running low, and recent pull requests and ideas. It never reads chat messages. Needs you stays your own.
- It is not rewritten on every visit. SAM checks after a page view whether something that matters changed (an item opened, answered or archived; a chat started, finished or failed; an automation started failing or recovered; an account crossed a usage level) and writes a new one in the background, at most once per interval and a limited number of times a day.
- While the facts have moved on, the old text stays, dimmed, with when it was written. A sentence about an item that has since closed (for example a question you just answered) disappears at once.
- It is not shown when there is nothing to say (nothing waiting and nothing running), when the brief could not be written, or when an administrator has switched it off. The rest of the page is the same either way.
Administrators control it in Admin → Settings → AI models (overviewBrief.*, see
Admin settings).
Needs you
Section titled “Needs you”The first items of this project’s Inbox: the questions, permission requests, secrets, approvals, reviews, results, tasks and problems waiting for you, in the same order as the Inbox. A phone shows three, a desktop five; the number next to the heading counts them all, and All, followed by that number, opens the project Inbox.
Tap an item to open it in the Inbox. Answer it there: a one-line receipt confirms it and the next item opens. Back to Overview returns you to the Overview, where the count is already lower. When nothing is waiting, the section is a single line, Nothing needs you.
Running now
Section titled “Running now”Chats in this project that an agent is working on now: the agent is in the middle of a turn, as the chat itself shows it. Each row shows the chat’s topic on one line (hover it for the whole topic), then how long it has been running and the profile it runs with, for example 1h 20m · Opus 5.5 Build.
- Starting means SAM is still finding or preparing a machine for it.
- Paused on this (amber) means the agent is stopped on something you need to answer, which is in Needs you: the Inbox uses the same words. A chat paused on someone else’s answer says Waiting for an answer.
Sleeping chats and chats whose agent has finished its turn are not listed, unless the agent is paused on a question or a secret request. Tap a row to open the chat, or Chats to see them all. When more are running than fit, the section says how many more.
This week
Section titled “This week”Three numbers for the last 7 days, each with its change from the 7 days before:
- Merged: pull requests merged in the project.
- Idea → merged: the median time from an idea being filed to its first pull request merging.
- CI first try: the share of pull requests whose first commit passed every check with no failure and no rerun.
Under them is the top blocker: the most common reason runs stopped before finishing (other than a person or coordinator stopping them on purpose), or the flakiest check, whichever affected more work. Insights opens the full Insights page on its 7-day range.
Budgets
Section titled “Budgets”One ring per account your project’s profiles run on, with the account’s name under it: the ring is the usage left on that account, the same ring the profile picker shows. Calm accounts are just a ring and a name. An account that needs your attention adds one short line under its name, in the window’s colour: how much is left (6% left), Out with when it is back, or Paused. Hover a ring, or listen to it with a screen reader, for the full words, which name the window, for example Weekly window · 6% left · resets 2d 3h. A profile with no account connected is named on one line under the rings. Accounts opens the project’s Settings → Accounts, where you connect and switch them. See Usage limits.
Automations
Section titled “Automations”Each automation that is failing gets one line with its fix, the same one the Automation page offers (for example Resume for an automation SAM paused after repeated failures). Reminders agents set to message their own chats are not counted: when one doesn’t run, there is nothing for you to fix. Below that is the next automation due to run. All opens the Automation page.
Recently
Section titled “Recently”The three ideas updated most recently and the three pull requests merged most recently. Ideas open their page; pull requests open on GitHub. Ideas opens the project’s Ideas page. See Ideas.
Start a task from the Overview
Section titled “Start a task from the Overview”The box at the bottom is the project chat’s own message box, with To (the profile), the account it runs on, attachments and Chat options. On a phone it is a single line until you tap it.
- Type what you want done.
- Optionally pick a profile under To.
- Select Send.
You stay on the Overview. The box clears, a line above it reads Started: … with an Open chat link, and the new task appears at the top of Running now. If the task cannot start, the same line says Couldn’t start: and why, and your text stays in the box so you can try again.
Everything on the page refreshes on its own while it is open: a chat starting, finishing or asking you something updates Running now within a couple of seconds.