Troubleshooting
tmux missing, Claude not running, Status unknown
The connection works, but the session doesn't. What each message means, and the fix.
On this page
tmux isn't installed
tmux isn't installed on devbox
Mucq connected, but the server has no tmux where an SSH command can find it. Install it, then choose Reconnect:
sudo apt install tmux
On a Mac with Homebrew, brew install tmux. If tmux is installed but Mucq still can't find it, it isn't on the PATH that SSH commands get. That's the usual case on a Mac, where Homebrew isn't on it: see step 2 of Use your Mac as the server.
The same problem shows in the server's header as Check failed, with the details in its tooltip.
Claude not running
The project's session runs a shell, not Claude. Claude exited, or never started. The terminal says what the shell said, so look there first:
claude: command not found, or your shell's version of it: Claude Code isn't installed for this user, or your login doesn't find it. Install it, check thatclauderuns after a fresh login, then choose Restart Claude (⇧⌘R).- Claude exited. Restart Claude (⇧⌘R) starts it again in the project folder and continues the conversation.
No status
Claude runs, but Mucq can't see what it's doing. It was started without Mucq's hooks: by hand in the session, or by an older Mucq. Or another program, such as vim or less, runs in the pane.
Restart Claude (⇧⌘R) restarts it with the hooks, and the conversation continues.
Status unknown
Mucq hasn't heard back from the server about this project yet. That's normal for a moment after Mucq starts or reconnects. If it stays, choose Refresh Status (⌥⌘R), and look at the server's header: Offline, Log in or Check failed says what's in the way.
Needs you, but Claude isn't asking anything
Claude asks some questions before it reports anything, such as whether to trust a new folder or to sign in. Mucq shows those as Needs you too. Open the project and answer in the terminal.