Terminal

Shell access in the browser#

Every desktop includes a browser-based terminal powered by xterm.js. You get a full bash shell as the agent user, with sudo access and standard Linux tools.

How it works#

The terminal connects through a terminal server running inside the VM. It serves a WebSocket-based terminal session that xterm.js renders in your browser. The connection goes through Le Bureau's authenticated proxy, so no SSH keys or port forwarding are needed.

Opening the terminal#

1. Go to your desktop in the dashboard.
2. Click the Terminal tab in the viewer panel.
3. The terminal connects automatically once the desktop is running.

You can have VNC and the terminal open side by side. They work independently.

Common tasks#

Installing packages#

sudo apt update && sudo apt install -y <package-name>

Installed packages persist across reboots unless the desktop is destroyed.

Managing files#

ls ~/Desktop/          # Files visible on the XFCE desktop
ls ~/                  # Home directory
df -h                  # Check disk usage

Working with the AI agent#

You can check the agent status from the dashboard's chat panel. If the agent is not responding, see the troubleshooting guide.

Keyboard shortcuts#

Tips#

• The terminal is faster than VNC for text-based work: file editing, package management, log viewing, scripts.
• If the terminal disconnects, click the tab again to reconnect. Running processes are not affected.
• Use tmux for multiple sessions or to keep processes alive across disconnections.
• Files in ~/Desktop/ are visible both in the terminal and on the XFCE desktop through the VNC viewer.