CloudCLI Plugin

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.

Features

• 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

Installation

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 build

Then restart CloudCLI UI to pick up the new plugin.

Plugin Structure

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

Dependencies

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.

Security

• Backend runs as an isolated child process with restricted environment variables
• Plugin server binds to 127.0.0.1 only — not reachable from the network
• WebSocket connections are authenticated through the CloudCLI host proxy
• No npm postinstall scripts

Requirements

• CloudCLI UI v1.0.0+
• Node.js 18+

License

MIT