Skip to content

Web UI

carryOn includes a built-in browser-based terminal client powered by xterm.js. It gives you a full terminal emulator in your browser with no plugins or extensions to install.

Start the web UI with a single command:

Terminal window
carryon config set local.enabled true

Once enabled, open http://127.0.0.1:8384 in your browser. You will see a list of all running sessions and can attach to any of them.

  • Session list - browse all active sessions and attach with a click.
  • Full terminal emulator - xterm.js provides a complete terminal experience including color, cursor positioning, and alternate screen support.
  • Multiple tabs - open several sessions side by side in separate browser tabs.
  • Mobile support - the interface works on phones and tablets, so you can check on a running process from anywhere on your local network.
  • Auto-reconnect - if your network drops or your phone goes to sleep, the web UI automatically reconnects when connectivity returns.

The web UI listens on 127.0.0.1:8384 by default. You can change the port and expose setting:

Terminal window
# Change the port
carryon config set local.port 8384
# Expose beyond localhost
carryon config set local.expose true

Accessing from other devices on your network

Section titled “Accessing from other devices on your network”

By default the web UI only listens on localhost. To access it from another device - such as your phone or a tablet - expose it:

Terminal window
carryon config set local.expose true

Then open http://<your-ip>:8384 from the other device, replacing <your-ip> with your machine’s local IP address.

CommandDescription
carryon statusCheck whether the web UI is running (included in unified status)
carryon config set local.enabled falseStop the web UI
  • Check on AI agents from your phone - open the web UI on your mobile device to see what your coding agent is doing.
  • Respond to prompts - approve or answer interactive prompts without walking back to your desk.
  • Monitor builds - keep a browser tab open with your build session while you work in your editor.
  • Quick access without SSH - reach your terminal sessions from any browser on your machine without setting up SSH keys or tunnels.