Skip to main content
WebMuxInstall WebMux

Run Kimi Code CLI remotely with WebMux

WebMux runs Kimi Code CLI in a persistent terminal on the server, so you can close your laptop and continue the same process from a phone or another computer's browser.

1. Install and sign in to Kimi Code CLI

On the machine running WebMux, follow the official Kimi Code 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
kimi
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 -- kimi

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

  • This is the current Kimi Code CLI; users of the old Kimi CLI should migrate first per the official docs.

Command checked upstream against official docs on 2026-10-31; page verified on 2026-11-03. All agents