# cloudcli-plugin-terminal

**Repository Path**: romand/cloudcli-plugin-terminal

## Basic Information

- **Project Name**: cloudcli-plugin-terminal
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-30
- **Last Updated**: 2026-05-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CloudCLI Plugin — Web Terminal

A full-featured terminal plugin for [CloudCLI UI](https://github.com/cloudcli-ai/cloudcli) powered by [xterm.js](https://xtermjs.org/). 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:**
```bash
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