Web Terminal

The web terminal provides a full-featured terminal experience in your browser.

Features

  • Full color support — xterm-256color compatible
  • Copy & paste — Standard keyboard shortcuts work
  • Responsive design — Works on mobile and desktop
  • Multiple sessions — Each browser tab gets its own session
  • Auto-reconnect — Automatically reconnects if connection drops

Technology

Built with xterm.js, the same terminal emulator used by VS Code.

Accessing the Terminal

Local Access

http://localhost:7860

Via Tailscale

https://your-machine-name.ts.net

Keyboard Shortcuts

ShortcutAction
Ctrl+CInterrupt/Cancel
Ctrl+DExit/EOF
Ctrl+LClear screen
Ctrl+Shift+CCopy (if supported)
Ctrl+Shift+VPaste (if supported)

Configuration

The terminal inherits your shell’s configuration (.zshrc, .bashrc, etc.).

You can customize the shell in config/default.json:

{
  "terminal": {
    "shell": "/bin/zsh",
    "scrollback": 5000
  }
}

Troubleshooting

Terminal not displaying correctly

Make sure your TERM environment variable is set to xterm-256color.

Connection drops frequently

Check your network stability. The terminal will auto-reconnect after 2 seconds.