Run Cursor CLI remotely with WebMux

1. Install and sign in to Cursor CLI

On the machine running WebMux, follow the official Cursor CLI docs (external link) to install it, and sign in as the same user that runs the WebMux service. WebMux does not install or sign in to CLIs and does not manage model keys.

2. Use the preset launch configuration

Interactive command

agent

Preset arguments

None

In “New session → Pre-type”, pick this launch configuration, choose a directory or worktree and create the session. You can also start it from a terminal on the server, detach with Ctrl+] and continue on your phone:

webmux run -- agent

Upgrades never rewrite an existing launch-configs.json; if this CLI is missing, add it in “Settings → Launch configurations → New” with the command above. Presets use the “load shell startup files” wrapper so the CLI sees the PATH from ~/.bashrc or ~/.zshrc. Existing installs (Chinese)

3. Terminal, hybrid sessions and alerts

Terminal

Persistent PTY terminal: a browser disconnect does not end the process, and you can reconnect and replay the buffer; a service restart ends the session.

Hybrid session (chat ↔ terminal)

Not supported; it uses the terminal view. Offering an ACP interface alone does not mean WebMux's switching and resume behavior has been adapted.

“Needs you” alerts

Generic: depends on whether the CLI emits OSC 7501, Warp structured events, OSC 9 / OSC 777 notifications or BEL; WebMux documents no CLI-specific setup. Alert setup (Chinese)

4. Known limits

• The command is agent, not the editor launcher cursor; the old cursor-agent command also matches the icon.