xCloud Terminal

xCloud Terminal (xterm) is the planned Ubuntu-installable terminal experience for xCloud:

• Direct mode: deterministic xcloud/xterm commands for scripts, CI, and DevOps runbooks.
• AI mode: a Claude Code-style agent shell opened with xcloud --ai, xterm --ai, xterm agent, or xterm chat.
• Bundled CLI: @xcloud/cli is a default dependency, so xCloud Terminal ships with direct xCloud commands by default.
• Same xCloud capabilities: the AI agent must use the same safe xCloud API/tool layer as direct commands, not a separate unsafe bypass.

This repository is intentionally separate from the Laravel app and builds on the standalone xCloudDev/xCloud-cli package.

Target UX

# Direct deterministic commands
xcloud servers list
xterm servers list
xterm sites status <site-uuid>
xterm api get /servers --output json

# AI agent shell
xcloud --ai
xterm --ai
xterm agent
xterm chat "Create a WordPress site on my smallest Hetzner server"

# Agent backend/mode switching
xterm --ai --agent local
xterm --ai --agent hosted --skills-repo https://github.com/xCloudDev/xcloud-agent-skills

# Safe writes need confirmation or --yes in non-interactive mode
xterm --ai --yes "purge cache for example.com"

Install target

npm install -g @xcloud/terminal
xterm --help
xcloud --ai

@xcloud/terminal exposes both xterm and xcloud binaries. Direct xcloud commands delegate to the bundled @xcloud/cli; xcloud --ai opens xCloud Terminal agent mode.

Homebrew and apt/deb packaging are planned after the first working release.

Current status

Initial repo scaffold only. The detailed branch analysis, architecture, and execution plan are in:

• docs/BRANCH-ANALYSIS.md
• docs/ARCHITECTURE.md
• docs/IMPLEMENTATION-PLAN.md