Reference
Project states
Every word Mucq shows beside a project, what it means, and how Mucq knows.
On this page
Each project's row says, in words, what Claude is doing. A symbol goes with each word, so a state is never told by colour alone, and rows never move: within a server they stay in name order, whatever their state.
Claude's four states
| State | What it means |
|---|---|
| Idle | Waiting for your next prompt. |
| Working | Claude is on it. Leave it be. |
| Done | Finished, and you haven't looked yet. The name stands out until you do; once you've seen it, it reads Idle. |
| Needs you | A question, a plan to approve, a permission. Also a question Claude asks before it starts, such as whether to trust a new folder. |
Needs you is the only state in the accent colour. Next Needing Attention (⇧⌘U) jumps to the next project that needs you, then to the ones that are done.
"Looked at" means the project is open, Claude is on screen (not the shell) and Mucq is the app in front.
The honest ones
When Mucq can't tell, it says so.
| State | What it means |
|---|---|
| Starting Claude… | Mucq has started Claude, and it's still drawing. |
| No status | Claude runs, but without Mucq's hooks: started by hand, or by an older Mucq. Or another program runs in the pane. Restart Claude (⇧⌘R) fixes it, and the conversation continues. |
| Claude not running | The session runs a shell, not Claude. Restart Claude starts it. |
| No session | There's no tmux session for the project yet. Opening it starts one, with Claude. |
| Status unknown | Mucq hasn't heard back from the server yet. Refresh Status (⌥⌘R) checks now. |
Connection words
These show while something happens between your device and the server.
| State | What it means |
|---|---|
| Connecting… | Mucq is connecting the project's terminal. |
| Restarting Claude… | Claude is restarting; the conversation continues. |
| Ending session… | Mucq is ending the session on the server. |
| Offline — reconnecting | The server isn't answering. Mucq reconnects when it does. |
| No local network access | Mucq isn't allowed on the local network yet. See Can't connect. |
| Connection lost | The connection dropped. Reconnect (⌘R) opens it again. |
| Connection ended | The connection closed. Reconnect (⌘R) opens it again. |
The server's header
Each server's header has a word of its own: Connected, Connecting…, Checking…, Offline, No local network access, Log in (open a project to log in) or Check failed (the server answers, but the last check failed; the header's tooltip says why).
How Mucq knows
When Mucq starts Claude, it passes settings with hooks. Claude Code runs a hook at each step: when a session starts, when you submit a prompt, when it uses a tool, when it asks or waits for a permission, when it stops. Each hook writes one word into an option of the project's tmux session, and Mucq reads those words with one tmux command every few seconds.
No agent runs on the server for this. Working also needs Claude's screen to be changing, so a Claude you stopped with esc, which runs no hook, reads Idle. A Claude started by hand has no hooks, which is why it reads No status until you restart it from Mucq.