Skip to content

Getting started

Your first session

Open a project, and Claude starts in its folder. From then on, its state is in words beside its name.

On this page

Open a project

Click a pinned project in the sidebar. On iPhone, tap it in the list.

Mucq connects to the server and attaches to the project's tmux session. If there is none yet, Mucq creates it in the project's folder and starts Claude Code there. The row reads Starting Claude…, and a moment later Claude is waiting for you.

The session is named after the folder, so webshop runs in a tmux session called webshop. More on that in tmux.

Opening a project that already has a session simply attaches to it. Whatever Claude was doing, it's still doing.

State in words

Every project's row says what Claude is up to: Idle, Working, Done or Needs you. When Claude asks a question, waits for a permission or finishes, the row tells you, so you can stop checking.

Rows never move. Claude reports its state through hooks Mucq passes to it when it starts it; no agent runs on the server for that. Every word is in Project states.

How Claude starts

Mucq starts Claude Code in the project folder with three settings of its own: the hooks that report its state, the folder where files you send land, and the terminal's theme.

Permission mode in Settings › Claude Code picks the mode Claude starts in. The default, Claude Code's default, passes no flag, so the mode set in Claude Code's own settings applies. The others are Auto, Accept edits, Plan, Don't ask and Bypass permissions (danger!). A project's own Claude settings can disable bypass mode.

The terminal's palette, Terminal in Settings › Appearance, is Dark, Light or Match System. Claude Code starts in the theme that matches.

Both settings apply to sessions Mucq starts. A running Claude keeps its mode and theme until you restart it.

The shell beside Claude

⌘T, Show Shell in the Project menu, swaps Claude for a shell in the same project folder, and ⌘T again brings Claude back. The shell has its own tmux session, so it never gets in Claude's way.

Restart, end, quit

  • Restart Claude (⇧⌘R) restarts Claude in its pane and continues the conversation. Mucq asks first while Claude is working.
  • End Session… ends the project's tmux session, Claude and the shell with it. The project stays pinned; opening it again starts a new session.
  • Quit (⌘Q) closes Mucq's connections. The tmux sessions keep running on the server, and Claude keeps working.