The inbox: one question per session, who acts next?
Every session sorted by whose move it is, the same on web, desktop and phone, and every action you can take on one: what it does, how to undo it, and its key.
Run five agents and a new job appears in your day: cycling through terminals asking each one whether it needs you. Agents do not page you. They finish, or stall on a permission prompt, and wait. The inbox replaces that loop with a single computed answer for every session on every machine: whose move is it?
Every session, whether it runs Claude Code, Codex, Cursor, OpenCode or pi, on your laptop or a cloud host, lands in one list. The list is not sorted by time. It is grouped by who acts next: you, the agent, a machine, or nobody.
The sections, in order
The inbox renders these sections top to bottom, and the order is the point: your moves first, then the agent's, then a machine's.
- Questions: a session asked you something. An open question from the agent, a tool waiting on approve or deny, a decision card, or a worker's open ask. Clicking one opens a full-width answer view anchored on the question, and answering advances to the next.
- Pinned: sessions you pinned to the top, whatever their state.
- New: sessions with no messages yet.
- Needs You (yellow): the ball is in your court.
- Done (cyan): delivered; read it when you like.
- Working: the agent is producing right now. Leave it alone.
- Dormant (blue): parked on a wake a machine owns, such as a scheduled check or a background watcher.
Below those sit three collapsed buckets that are nobody's move: Snoozed, Stashed (with a "kill all" button) and Killed. On a busy day they hold hundreds of sessions, none of them in your way.
A session's section is decided first by anything you did to it (stashed, snoozed, killed), then by whether it is asking you something, then by a pin, then by being empty, and only then by its work state. A pinned session keeps its state underneath, so the counts stay honest.
The five work states, and what moves a session between them
Every session carries one of five work states: Working, Needs You, Done, Dormant, Idle. One shared function computes it everywhere, so the web inbox, the phone, push notifications and the Lock Screen can never disagree about where a session belongs.
It reads what the agent's process is doing, what the transcript shows, what the agent said about itself, and what you did to the card. The rules, in order:
- Killed wins. A killed session is idle, and nothing but a new message from you makes it look busy again.
- Snooze. A snoozed session is dormant until its time comes, then needs you.
- Your own verdict. If you filed the row yourself (dragged it into a section, or chose Mark done, Dormant or Mark needs you), it stays there. This outranks even hard blocks, because you already saw them. It expires on the next activity, so it can never hide a new ask.
- Hard blocks go to Needs You: an error banner ("Please run /login", a usage limit), an open question, a permission prompt.
- Producing goes to Working: the agent is thinking, compacting, starting or resuming, or there is queued work a live machine can deliver.
- Dead or unresponsive with output goes to Needs You: someone has to read it or restart it (unless it exited right after saying it was done, the ordinary end of a scheduled run).
- Settled (the turn ended) picks a resting place, in trust order: the agent said it is blocked, so Needs You; it named a wake, or a schedule or loop is armed into it, or one of its workers is still running, so Dormant; it said done, so Done; a classifier read the turn and judged it delivered, so Done. Anything else falls through to Needs You.
- Not settled, no status: you just sent a message it has not picked up, so Working. No messages at all is Idle.
Two trust limits keep agents honest. "I'm waiting on something" is a promise about a wake. If codecast can see the wake (an armed schedule, a running background task, a worker still producing) the session parks indefinitely. If not, the claim holds for two hours of quiet, and then the card moves back to Needs You marked as an unverified claim. And "done" or "dormant" covers only the turn that says it: after the next wake the agent has to say it again, or the session returns to Needs You.
State lines: the agent's own answer to "where does this stand?"
An agent can pin one short block of text to its session, shown above the composer and on the inbox card. In the hero shot above, "the 4242 test card is rate limit…" and "tests green, PR open for review" are state lines. The card shows how many messages have passed since the line was written, so a stale line looks stale.
Each state line also carries the agent's answer to who acts next: still moving, blocked on you, done, or parked on a named wake ("waiting on CI run 8841, re-checks at 3pm"). That answer decides where the card files when the turn ends. A "blocked" outranks every machine wake: if a schedule keeps waking a session but the agent said a human must act, the card says so where you look, and it pulls a stashed session back into view.
Answering without leaving the inbox
Most of the time you clear a card by replying to it. The composer at the bottom of a conversation types into the agent's real terminal as its next turn, so a reply flips the session from Needs You back to Working. Alt+Enter sends and opens the next card, Alt+Shift+Enter sends and stashes, and Ctrl+Enter queues the message behind the current turn. On a permission prompt, y approves and n denies.
When an agent needs a choice only you can make, it posts a decision card: one question, options with their cost and risk, and its reasoning. The card drops over the conversation, the session moves to Questions, and the left nav grows a Questions count.
Every action on a session
When you are not going to reply right now, you park the card. Three surfaces share one vocabulary, with the same icons and colors:
- The triage bar, one quiet row under the composer, shows three words: Defer, Stash and Kill, the verbs that settle nearly every card. Its "more" button opens the full menu.
- The right-click menu on any card is that same menu, every verb with its shortcut beside it.
- The keyboard, for triage without the mouse:
Ctrl+JandCtrl+Kmove between cards, a chord files the selected one, repeat.
The parking verbs, lightest first:
- Defer: not now. The card drops down the stack and comes back on its next activity.
- Dormant: parked; a machine wakes it (a schedule, a watcher, another session).
- Stash: out of the inbox, and the agent keeps running. It comes back on its own when a scheduled run fires into it, when the agent says it is blocked, or when it stalls on a prompt, a question or a dead process.
- Stash and hide: a stash that stays out through scheduled wakes. Only a real ask brings it back. Made for a recurring loop you have reviewed and want quiet.
- Kill: done with it. Tears the agent down, cancels anything scheduled into it, and files it under Killed. The transcript stays readable and the session restartable.
Two filing verbs remove nothing: Pin (top of the list) and Label (one of your personal labels; a session carries at most one, and teammates never see yours). Dragging a card into Needs You, Done or Dormant is the same verdict as the menu item. Working is not a drop target: nobody can declare that an agent is producing. Every action lands in the undo history (Ctrl/Cmd+Z); undoing a kill brings the card back, but the agent stays stopped until you restart it.
| Action | Where in the app | Shortcut | On the phone | What happens |
|---|---|---|---|---|
| Reply | Composer | Enter; Alt+Enter sends and advances | Open the session, type | Lands in the agent's terminal as its next turn; card goes to Working |
| Approve / deny | The permission prompt | y / n | Buttons on the prompt | Answers the waiting tool |
| Defer | Triage bar, right-click | Shift+Backspace | Card sinks until its next activity | |
| Dormant | Triage bar "more", right-click | Alt+Shift+Backspace | Files under Dormant until the next wake | |
| Mark done / needs you | Right-click, or drag the card | Files the card where you put it, until the next activity | ||
| Snooze | Right-click ("Snooze…") | Alt+Z | Dormant until the time you pick; "Move to Needs You now" wakes it early | |
| Stash | Triage bar, right-click | Ctrl+Backspace | Swipe left, or long-press | Out of the inbox; agent keeps running |
| Stash and hide | Triage bar "more", right-click | Ctrl+Alt+Backspace | Stays out until an ask | |
| Kill | Triage bar, right-click | Ctrl+Shift+Backspace | Long-press, then confirm | Agent stopped, schedules cancelled, filed under Killed |
| Restore | Right-click on a stashed or killed card | Back in the inbox (a killed agent stays stopped) | ||
| Pin | Triage bar "more", right-click | Ctrl+Shift+P; jump to pinned with Ctrl+P (Mac) | Swipe right, or long-press | Top of the list, state kept underneath |
| Label | Triage bar "more", right-click | Ctrl+L | Long-press, "Label…" | Files under a personal label |
| Mark unread | Right-click | Ctrl+Shift+U | Long-press | Card keeps its dot until you next open it |
| Rename | Right-click | Ctrl+Shift+E | New title on the card | |
| Hand off | From an open conversation | Alt+Shift+H | Picks a teammate; the session moves into their inbox | |
| Jump to most urgent | Ctrl+I | Opens the top Needs You card | ||
| Cycle the view | Ctrl+, | Grouped by state, by time, or by label | ||
| Everything else | Command palette | Cmd+K | Search plus every verb on the selected session |
The right-click menu also carries a few session-level actions that are not triage: favorite, change the model and effort, move the session to another machine, copy its link, and delete.
The command palette
Cmd+K opens one palette for everything: search across sessions, tasks and docs, and the session verbs in modes (snooze picks a time, label picks a label, model switches the model, delete confirms). Shortcuts like Alt+Z and Ctrl+L open the palette straight into that mode for the selected card.
Assignment decides whose inbox a session is in
Three things about a session move independently: whose account runs it, which machine it runs on, and who owns it. Ownership is the one that decides inboxes. A session you run but do not own leaves your inbox, takes its open questions with it, and stops ringing your phone. An unowned session (most of them) stays with whoever started it.
- An owned session stays in the owner's inbox with no age limit and no status gate. A handoff nobody has opened in six weeks is exactly the one that must not age out.
- A handoff clears the previous holder's stash and snooze, so the session lands where the new owner can see it. A kill is left alone; that session is retired.
- A bot account on a shared machine can park a session on a human reviewer: it shows in the reviewer's Needs You marked with who runs it.
A good handoff is more than a reassignment: the agent pins a "blocked" state line written for someone who has not read the thread, adds the teammate as owner, and leaves them one note.
Team feed vs. your inbox
Your inbox holds sessions you own or started and still hold. The team feed is wider: the team's recent sessions, filterable by person, state and label. A teammate's session appears there because the team can see it, which says nothing about whose move it is. It enters your inbox only when you own it.
Agents read the same states. One that orchestrates workers watches for a worker moving to Needs You or Done, reads it, and sends the next step, the way you would.
The inbox on the phone
The iOS app runs the same placement over the same data, so its sections and counts match the web exactly. Swipe a card left to stash it, right to pin it, and long-press for the rest (pin, favorite, mark unread, label, stash, kill). A session handed to you arrives with a "Got it" row to acknowledge it. Replying from the phone is the same as typing at the terminal: the agent gets your message as its next turn and carries on.
Off the app, a single Live Activity on the Lock Screen and Dynamic Island shows every live session's state, from the same verdict: Working reads as working, Needs You as waiting, Done as done, and a dead process or error banner as failed. Status changes arrive at once. Workers and hidden sessions never reach it, the same etiquette the push notifications follow.






