> ## Documentation Index
> Fetch the complete documentation index at: https://docs.myrax.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Terminal

> Full PTY shell in the browser

<img src="https://mintcdn.com/sosalkini/dxv3YWGIc-AzMEZ_/images/terminal-banner.png?fit=max&auto=format&n=dxv3YWGIc-AzMEZ_&q=85&s=362cb786588b0eb6ddd50b9a3d37695a" alt="Terminal plugin" width="1280" height="640" data-path="images/terminal-banner.png" />

A real shell in the panel — xterm.js on the front, a pty over websocket on the
back. vim, htop, ssh and tab-completion all work.

## Install

```sh theme={null}
myrax plugin install terminal
```

or **Plugins → store → Terminal** in the panel. A **Terminal** tab appears in
the sidebar.

No extra dependencies: the pty runtime ships inside the Myrax binary itself —
the manifest points at `myrax plugin-runtime terminal`.

## What you get

* Login shell with full TTY semantics, 6000 lines of scrollback.
* Monochrome theme matching the panel; auto-fit on window resize.
* Reconnect and clear buttons, connection state indicator.

## How it works

The runtime exposes two endpoints, proxied by the panel:

```text theme={null}
GET /health      liveness
WS  /terminal    raw pty stream (stdin/stdout + resize messages)
```

The frontend connects through `/api/plugins/terminal/ws/terminal`, so the
websocket rides the same origin, port and session auth as the panel.

Requires Myrax >= 0.1.0.
