# Which of my coding sessions needs me?

> When several Claude Code and Codex sessions run at once, Zeus Mode shows you which one is waiting for your answer, and what it asked.

*You started three coding sessions, went to read something, and one of them
stopped to ask you a question. This page shows how Zeus Mode tells you which
one, and what it asked, without opening every terminal.*

**Checked on 18 November 2026** with Zeus Mode 0.41.0 on macOS 27.0.1. The
pictures were taken earlier, on Zeus Mode 0.35.0 with Claude Code 2.1.322 and
Codex 0.166.0, in a small demo project called tinytodo.

## What Zeus Mode is

Zeus Mode for Claude Code and Codex is a Mac app with a small background
program. The background program watches every Claude Code and Codex session on
your Mac. The app shows, in one window, what each session is doing and which
ones wait on you.

You keep the terminals you already use. Zeus Mode is one more window. It never
answers a question for you: you still answer in the session's own terminal.

## Before you start

- **Zeus Mode on your Mac**, set up and running. If you do not have it yet,
  follow [Getting started with Zeus Mode](/docs/getting-started/).
- **The repository in a workspace.** A *workspace* is the group of
  repositories one Dashboard shows; its name is at the top left of the
  window. The repository your sessions run in must be one of them, and that
  workspace must be picked. In the pictures, the workspace is **Zeus Demo**,
  with one repository, tinytodo.
- **One or more sessions** of Claude Code or Codex, running in that
  repository.

## 1 · Open the Dashboard

Open Zeus Mode: the app is called Zeus in your Applications folder. The page
**Dashboard** opens. One line at the top counts the sessions that are running
(it calls them *runs*) and what needs your review — for example "2 runs are
going · nothing needs your review." Questions are not in this count.

Under it is a bar with five parts: **For you**, **Open PRs**, **Documents**,
**Sessions** and **Work items**. Each part shows a count.

## 2 · See every session in one list

Pick **Sessions** in the bar. Each running session has one row: its name, the
work it was given, and what it is doing now.

[![The Dashboard of the Zeus Mode app for the workspace Zeus Demo, with the line "2 runs are going · nothing needs your review." The bar reads For you 0, Open PRs 0, Documents 0, Sessions 2 and Work items 2, with Sessions picked. Under SESSIONS 2, two rows: "a one-off session — Summarize agent responsibilities — exec — 38 s", and "Claude — Research new ways to build demos of Zeus. — researching new ways to build demos of Zeus, reading what exists first, no ETA — 1 min".](/images/docs/sessions-claude-code-and-codex.jpg)](/images/docs/sessions-claude-code-and-codex.jpg)

The row does not print the tool's name. A session that works as an agent
shows the agent's name. A session that works as no agent — what you get when
you start `claude` or `codex` in a terminal and give it no agent name — is
named **a one-off session**.

In the picture, **a one-off session** is a Codex session started that way.
The row **Claude** is a Claude Code session that had given itself the agent
name `claude`; a Claude Code session with no agent name would also be
**a one-off session**.

## 3 · A session asks you something

In the pictures, the Claude Code session — the one with an agent name —
stopped to ask a question with four choices. The count beside **For you**
went up to 1. Pick **For you** in the bar: the question is there, under
**WAITING ON YOU**, as a card.

[![The Dashboard with For you 1 picked. Under WAITING ON YOU 1, one card: "Claude · ses_2bfc965dba67 · asked 1 min ago", then the question "Which demo of Zeus should I build?", a line of context, "Claude is blocked until you answer. Zeus cannot answer this one for you.", WHAT WAITS FOR THIS ANSWER "Claude resumes", four choices — Replay of a real run (Recommended), Click-through web demo, Composed video, Terminal clip — then "Answer in Claude's terminal.", "The choices above are shown so you can decide before you switch.", the folder ~/src/tinytodo and a process number, a Session details button and Dismiss.](/images/docs/for-you-question-waiting.jpg)](/images/docs/for-you-question-waiting.jpg)

The card tells you:

- **who asked**, and when — here, "Claude · … · asked 1 min ago";
- **the question**, and the choices it offers, with the one the session
  recommends marked "(Recommended)";
- **what waits for your answer** — here, "Claude resumes";
- **where to answer** — "Answer in Claude's terminal." The card shows the
  choices so you can decide before you switch;
- **which folder** the session runs in, and its process number.

**Session details** opens more about the session. **Dismiss** takes the card
off the Dashboard; nothing is deleted.

### A session with no agent name that finished its work

The Codex session — the one with no agent name — did what it was asked and
then waited for its next message. Under **Sessions**, it was listed in its
own group, **OPEN, WAITING FOR YOU**, "not counted as running", with how long
it had waited:

[![The Dashboard with Sessions 0 picked. It reads "Nothing is running on this machine right now. Zeus is watching. A row appears here as soon as a session starts." and "1 run never reported finishing. Zeus will not call them running — the last thing it saw of it was 1 min ago." Below, the group OPEN, WAITING FOR YOU, "1 · not counted as running", with one row: an open circle, "a one-off session — Summarize agent responsibilities — in ~/src/tinytodo — waiting 44 s".](/images/docs/sessions-open-waiting-for-you.jpg)](/images/docs/sessions-open-waiting-for-you.jpg)

At that moment the **Sessions** list itself was empty: "Nothing is running
on this machine right now."

## 4 · Every question, from every workspace

**Needs you**, at the top of the sidebar, gathers what waits on you from all
your workspaces. Its bar has seven tabs: **All**, **Questions**, **Passed to
you**, **To start**, **Pull requests**, **Given to you** and **To read**.
Each tab always shows its number, also when it is 0. The **WORKSPACE**
button on the right shows one workspace at a time: set it to the workspace
your repository is in.

In a small window, nothing is cut off. First the button loses its small
word "WORKSPACE". Then it moves to a second line, under the tabs. If the
window is narrower still, the tabs scroll sideways. The **Dashboard**'s tabs
(**For you**, **Open PRs**, **Documents**, **Sessions** and **Work items**)
also always show their numbers, and scroll sideways when the window is too
narrow.

Pick **Questions** to see only the questions. The same card is there:

[![The Needs you page in Zeus Mode 0.35.0, before the Given to you tab, "all workspaces", with a line counting what waits on you. The bar reads All 1, Questions 1, Passed to you 0, To start 0, Pull requests 0, To read 0, with Questions picked, and the WORKSPACE button set to Zeus Demo. A line reads "Showing 1 of your 24 · Zeus Demo · Questions" with Clear. Under WAITING ON YOU 1, the same card from Claude: "Which demo of Zeus should I build?"](/images/docs/needs-you-questions-one.jpg)](/images/docs/needs-you-questions-one.jpg)

The larger counts on this page and beside **Needs you** in the sidebar come
from other workspaces on the same Mac.

## 5 · Answer in the session's terminal

Switch to the session's terminal and answer there. Zeus Mode sees the answer,
and the question leaves the list:

[![The Needs you page with Questions 0 picked and the workspace Zeus Demo. It reads "No questions wait on you in Zeus Demo." and "A question an agent there asks appears here.", with a button Show all of Zeus Demo and a link Clear.](/images/docs/needs-you-questions-none.jpg)](/images/docs/needs-you-questions-none.jpg)

The count beside **Needs you** in the sidebar goes down by one.

## 6 · When a page says "Not refreshed since"

Sometimes the Zeus Mode app loses its link to its background program for a
moment, for example when your Mac is very busy. Sometimes the background
program cannot read your work for a moment. In both cases, the lists stay on
the screen. Under the page's title, a line such as **Not refreshed since
14:52** tells you the lists show your work as it was at that time. You can
see this line on **Needs you**, the **Dashboard**, **Project plans**,
**Explorations**, and a plan's or an exploration's own page.

While the line shows, some buttons do nothing and tell you why. A button that
sends something from the app — a plan step's or an exploration round's
button, or an answer you give in the app — says:

- after a reconnect: "Service unavailable — Zeus is connecting again to its
  background program. Nothing was sent. Try again in a moment."
- when your work could not be read: "Zeus could not read your work just now.
  Nothing was sent. Try again in a moment."

So nothing is lost: wait a moment and try again. The line
goes away by itself when the lists are fresh again. Your teammates keep
seeing your last summary in the meantime.

## Next

- [Can I see my Claude Code and Codex sessions in one place?](/docs/claude-code-and-codex/)
  shows how both tools share the same list.
- [Planning work across agents with metis](/docs/planning-with-metis/) shows
  how to hand a bigger piece of work to several agents at once.
