Remote Terminal
The remote terminal is an optional agent capability that gives you an interactive shell on the device from your browser. It is available from agent version 1.0.24.
WARNING
The remote terminal runs as the root user on the device. Anyone who can open a terminal on a device has full administrative control of it. Only install this capability where remote shell access is genuinely required.
Before you start
The remote terminal requires all of the following:
| Requirement | Description |
|---|---|
| Agent version | 1.0.24 or later. |
| Capability installed | The agent must have been installed with the Remote terminal capability, using the Advanced or Custom install type. For more information, see Capabilities. |
| Enrolment complete | The capability shows On rather than Enrolling on the Agent Settings page. |
| Device online | The device is connected to the platform. |
| Permission | Your user has permission to open a terminal on the device. |
The remote terminal does not require CloudLink. The two capabilities are independent, and you can install either without the other.
Opening a terminal
- In the device treeview, select the device.
- Open the terminal for that device.
The session opens directly against the device. If the capability was installed recently, the device may still be completing its key exchange, in which case the terminal reports that the device is still starting its terminal service. Wait a moment and try again.
Working with sessions
You can open several terminal sessions against the same device. Each session appears as its own tab, and all tabs share a single encrypted connection to the device.
- To open another session, add a new tab.
- To close a session, close its tab.
- Closing the page closes every open session on that device.
There is no fixed limit on the number of tabs in the interface. The device itself sets the practical limit, and a session opened beyond what the device will accept is refused with a message explaining why.
Sessions are kept alive while the page is open. If your connection drops and recovers, the session reconnects.
Command line tools
The terminal offers a launch option for several AI command line tools. Selecting one installs the tool if it is not already present on the device, then starts it. Selecting it again later just starts it.
| Tool | Command |
|---|---|
| Claude Code | claude |
| Codex CLI | codex |
| Antigravity CLI | agy |
Each option also shows the official install command, which you can copy and run yourself instead.
INFO
These tools are third-party software installed from their vendors' official installers. They are downloaded to the device at the time you select them and are not bundled with the agent.
Security
- Encrypted to the device. The session is encrypted end to end between your browser and the device, independently of the transport carrying it.
- Bound to one user. A terminal connection is bound to the identity that opened it. A different user cannot attach to a connection that has already been claimed.
- Not enabled by default. The capability is absent from a Core install. It has to be deliberately selected at install time, and adding it later requires a reinstall.
- Runs as root. There is no reduced-privilege mode.
Troubleshooting
| Message | Cause and action |
|---|---|
| Cannot reach the device. It may be offline. | The device is not answering. Confirm it is online on the Agent Settings page, then reopen the terminal. |
| The device is still starting its terminal service. | Enrolment has not finished. Wait a moment and try again. |
| This device does not support terminals. | The agent does not have the remote terminal capability installed, or is older than 1.0.24. Update the agent and reinstall with the Advanced or Custom install type. |
| You do not have permission to open a terminal on this device. | Your user lacks the required permission. Contact your account administrator. |
| The terminal is unavailable right now. | A platform-side fault. If it continues, contact support@mutexer.com. |