Cloud CLI (aka Claude Code UI)

A desktop and mobile UI for Claude Code, Cursor CLI, Codex, and Gemini-CLI.
Use it locally or remotely to view your active projects and sessions from everywhere.

CloudCLI Cloud · Documentation · Discord · Bug Reports · Contributing

English · Русский · Deutsch · 한국어 · 简体中文 · 繁體中文 · 日本語 · Türkçe

Screenshots

Desktop View Main interface showing project overview and chat	Mobile Experience Responsive mobile design with touch navigation
CLI Selection Select between Claude Code, Gemini, Cursor CLI and Codex

Features

Responsive Design - Works seamlessly across desktop, tablet, and mobile so you can also use Agents from mobile
Interactive Chat Interface - Built-in chat interface for seamless communication with the Agents
Integrated Shell Terminal - Direct access to the Agents CLI through built-in shell functionality
File Explorer - Interactive file tree with syntax highlighting and live editing
Git Explorer - View, stage and commit your changes. You can also switch branches
Session Management - Resume conversations, manage multiple sessions, and track history
Plugin System - Extend CloudCLI with custom plugins — add new tabs, backend services, and integrations. Build your own →
TaskMaster AI Integration (Optional) - Advanced project management with AI-powered task planning, PRD parsing, and workflow automation
Model Compatibility - Works with Claude, GPT, and Gemini model families (the full list of supported models is available at runtime via GET /api/providers/:provider/models)

Quick Start

CloudCLI Cloud (Recommended)

The fastest way to get started — no local setup required. Get a fully managed, containerized development environment accessible from the web, mobile app, API, or your favorite IDE.

Get started with CloudCLI Cloud

Self-Hosted (Open source)

npm

Try CloudCLI UI instantly with npx (requires Node.js v22+):

hljs language-bash

npx @cloudcli-ai/cloudcli

Or install globally for regular use:

hljs language-css

npm install -g @cloudcli-ai/cloudcli
cloudcli

Open http://localhost:3001 — all your existing sessions are discovered automatically.

Visit the documentation → for full configuration options, PM2, remote server setup and more.

Docker Sandboxes (Experimental)

Run agents in isolated sandboxes with hypervisor-level isolation. Starts Claude Code by default. Requires the sbx CLI.

hljs language-perl

npx @cloudcli-ai/cloudcli@latest sandbox ~/my-project

Supports Claude Code, Codex, and Gemini CLI. See the sandbox docs for setup and advanced options.

Which option is right for you?

CloudCLI UI is the open source UI layer that powers CloudCLI Cloud. You can self-host it on your own machine, run it in a Docker sandbox for isolation, or use CloudCLI Cloud for a fully managed environment.

	Self-Hosted (npm)	Self-Hosted (Docker Sandbox) (Experimental)	CloudCLI Cloud
Best for	Local agent sessions on your own machine	Isolated agents with web/mobile IDE	Teams who want agents in the cloud
How you access it	Browser via `[yourip]:port`	Browser via `localhost:port`	Browser, any IDE, REST API, n8n
Setup	`npx @cloudcli-ai/cloudcli`	`npx @cloudcli-ai/cloudcli@latest sandbox ~/project`	No setup required
Isolation	Runs on your host	Hypervisor-level sandbox (microVM)	Full cloud isolation
Machine needs to stay on	Yes	Yes	No
Mobile access	Any browser on your network	Any browser on your network	Any device, native app coming
Agents supported	Claude Code, Cursor CLI, Codex, Gemini CLI	Claude Code, Codex, Gemini CLI	Claude Code, Cursor CLI, Codex, Gemini CLI
File explorer and Git	Yes	Yes	Yes
MCP configuration	Synced with `~/.claude`	Managed via UI	Managed via UI
REST API	Yes	Yes	Yes
Team sharing	No	No	Yes
Platform cost	Free, open source	Free, open source	Starts at $7/month

All options use your own AI subscriptions (Claude, Cursor, etc.) — CloudCLI provides the environment, not the AI.

Security & Tools Configuration

🔒 Important Notice: All Claude Code tools are disabled by default. This prevents potentially harmful operations from running automatically.

Enabling Tools

To use Claude Code's full functionality, you'll need to manually enable tools:

Open Tools Settings - Click the gear icon in the sidebar
Enable Selectively - Turn on only the tools you need
Apply Settings - Your preferences are saved locally

Tools Settings Modal Tools Settings interface - enable only what you need

Recommended approach: Start with basic tools enabled and add more as needed. You can always adjust these settings later.

Plugins

CloudCLI has a plugin system that lets you add custom tabs with their own frontend UI and optional Node.js backend. Install plugins from git repos directly in Settings > Plugins, or build your own.

Available Plugins

Plugin	Description
Project Stats	Shows file counts, lines of code, file-type breakdown, largest files, and recently modified files for your current project
Web Terminal	Full xterm.js terminal with multi-tab support
Claude Watch	Watches long-running Claude Code sessions for hangs and exposes process controls
CloudCLI Scheduler	Create workspace-scoped scheduled prompts and execute them through a local CLI such as Codex, Claude Code, or Gemini CLI
PRISM CloudCLI	Session intelligence for Claude Code inside CloudCLI, including token burn visibility
Sessions	View, manage, and kill active Claude Code sessions
Token Cost Calculator	Calculate API costs from model prices and token usage, with preset model pricing support
Task Queue	Task queue dashboard to view, filter, and launch agent tasks
GitHub Issues Board	Kanban board for GitHub Issues with bidirectional TaskMaster sync and /github-task CLI skill auto-install

Build Your Own

Plugin Starter Template → — fork this repo to create your own plugin. It includes a working example with frontend rendering, live context updates, and RPC communication to a backend server.

Plugin Documentation → — full guide to the plugin API, manifest format, security model, and more.

FAQ

How is this different from Claude Code Remote Control?

Claude Code Remote Control lets you send messages to a session already running in your local terminal. Your machine has to stay on, your terminal has to stay open, and sessions time out after roughly 10 minutes without a network connection.

CloudCLI UI and CloudCLI Cloud extend Claude Code rather than sit alongside it — your MCP servers, permissions, settings, and sessions are the exact same ones Claude Code uses natively. Nothing is duplicated or managed separately.

Here's what that means in practice:

All your sessions, not just one — CloudCLI UI auto-discovers every session from your ~/.claude folder. Remote Control only exposes the single active session to make it available in the Claude mobile app.
Your settings are your settings — MCP servers, tool permissions, and project config you change in CloudCLI UI are written directly to your Claude Code config and take effect immediately, and vice versa.
Works with more agents — Claude Code, Cursor CLI, Codex, and Gemini CLI, not just Claude Code.
Full UI, not just a chat window — file explorer, Git integration, MCP management, and a shell terminal are all built in.
CloudCLI Cloud runs in the cloud — close your laptop, the agent keeps running. No terminal to babysit, no machine to keep awake.

Do I need to pay for an AI subscription separately?

Yes. CloudCLI provides the environment, not the AI. You bring your own Claude, Cursor, Codex, or Gemini subscription. CloudCLI Cloud starts at $7/month for the hosted environment on top of that.

Can I use CloudCLI UI on my phone?

Yes. For self-hosted, run the server on your machine and open [yourip]:port in any browser on your network. For CloudCLI Cloud, open it from any device — no VPN, no port forwarding, no setup. A native app is also in the works.

Will changes I make in the UI affect my local Claude Code setup?

Yes, for self-hosted. CloudCLI UI reads from and writes to the same ~/.claude config that Claude Code uses natively. MCP servers you add via the UI show up in Claude Code immediately and vice versa.

Community & Support

Documentation — installation, configuration, features, and troubleshooting
Discord — get help and connect with other users
GitHub Issues — bug reports and feature requests
Contributing Guide — how to contribute to the project

License

GNU Affero General Public License v3.0 or later (AGPL-3.0-or-later) — see LICENSE for the full text, including additional terms under Section 7.

This project is open source and free to use, modify, and distribute under the AGPL-3.0-or-later license. If you modify this software and run it as a network service, you must make your modified source code available to users of that service.

CloudCLI UI - (https://cloudcli.ai).

Acknowledgments

Built With

Claude Code - Anthropic's official CLI
Cursor CLI - Cursor's official CLI
Codex - OpenAI Codex
Gemini-CLI - Google Gemini CLI
React - User interface library
Vite - Fast build tool and dev server
Tailwind CSS - Utility-first CSS framework
CodeMirror - Advanced code editor
TaskMaster AI (Optional) - AI-powered project management and task planning

claudecodeui

Cloud CLI (aka Claude Code UI)

Screenshots

Desktop View

Mobile Experience

CLI Selection