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.
Enabling the web UI
Section titled “Enabling the web UI”Start the web UI with a single command:
carryon config set local.enabled trueOnce 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.
Features
Section titled “Features”- 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.
Configuration
Section titled “Configuration”The web UI listens on 127.0.0.1:8384 by default. You can change the port and expose setting:
# Change the portcarryon config set local.port 8384
# Expose beyond localhostcarryon config set local.expose trueAccessing 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:
carryon config set local.expose trueThen open http://<your-ip>:8384 from the other device, replacing <your-ip> with your machine’s local IP address.
Managing the web UI
Section titled “Managing the web UI”| Command | Description |
|---|---|
carryon status | Check whether the web UI is running (included in unified status) |
carryon config set local.enabled false | Stop the web UI |
Use cases
Section titled “Use cases”- 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.