A full-featured terminal plugin for CloudCLI UI powered by xterm.js. Open multiple terminal tabs, pick a theme, and work directly in the browser — no SSH or external terminal needed.
- Multi-tab support — open multiple terminal sessions side by side
- Persistent sessions — PTY processes and WebSocket connections stay alive when you switch tabs
- Themes — VS Dark, One Dark, Dracula, Solarized Dark, and Light
- Adjustable font size — increase / decrease from the toolbar
- WebGL rendering — GPU-accelerated rendering with automatic canvas fallback
- Unicode 11 — full emoji and wide-character support
- Auto-resize — terminal reflows when the panel is resized
From CloudCLI UI (recommended): Open Settings > Plugins, paste this repository URL, and click Install. CloudCLI will clone the repo, install dependencies, and start the backend server automatically.
Manual:
git clone --depth 1 https://github.com/cloudcli-ai/cloudcli-plugin-terminal.git \
~/.claude-code-ui/plugins/web-terminal
cd ~/.claude-code-ui/plugins/web-terminal
npm install
npm run buildThen restart CloudCLI UI to pick up the new plugin.
| Path | Purpose |
|---|---|
manifest.json |
Plugin metadata — name, version, slot, entry points |
src/index.ts |
Frontend source — xterm.js UI, tabs, themes, keyboard |
src/server.ts |
Backend source — spawns PTY shells, serves WebSocket |
src/types.ts |
Shared TypeScript type definitions |
dist/ |
Compiled output (generated by npm run build) |
icon.svg |
Tab icon displayed in the CloudCLI sidebar |
| Package | Why |
|---|---|
node-pty |
Spawn native pseudo-terminal processes |
ws |
WebSocket server for real-time terminal I/O |
xterm.js and its addons are loaded at runtime from CDN — no frontend build step required.
- Backend runs as an isolated child process with restricted environment variables
- Plugin server binds to
127.0.0.1only — not reachable from the network - WebSocket connections are authenticated through the CloudCLI host proxy
- No npm
postinstallscripts
- CloudCLI UI v1.0.0+
- Node.js 18+
MIT
