Skip to content

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

StateWhat it means
IdleWaiting for your next prompt.
WorkingClaude is on it. Leave it be.
DoneFinished, and you haven't looked yet. The name stands out until you do; once you've seen it, it reads Idle.
Needs youA 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.

StateWhat it means
Starting Claude…Mucq has started Claude, and it's still drawing.
No statusClaude 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 runningThe session runs a shell, not Claude. Restart Claude starts it.
No sessionThere's no tmux session for the project yet. Opening it starts one, with Claude.
Status unknownMucq 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.

StateWhat 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 — reconnectingThe server isn't answering. Mucq reconnects when it does.
No local network accessMucq isn't allowed on the local network yet. See Can't connect.
Connection lostThe connection dropped. Reconnect (⌘R) opens it again.
Connection endedThe 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.