Skip to content

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:

Shell
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 that claude runs 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.