claudecodeui

Cloud CLI (aka Claude Code UI) A desktop and mobile UI for Claude Code, Cursor CLI, and Codex.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 · Bahasa Indonesia

Screenshots

Desktop View Main interface showing project overview and chat Mobile Experience Responsive mobile design with touch navigation CLI Selection Select between Claude Code, 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

• Browser Use - Open browser sessions for web research, testing, and agent-driven browser tasks

• 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 and GPT 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+):

npx @cloudcli-ai/cloudcli

Or install globally for regular use:

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.

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

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

Desktop Companion App

CloudCLI Desktop is an optional native companion for CloudCLI Cloud and Local CloudCLI. It ships from this repository's GitHub Releases and keeps CloudCLI available from your menu bar or tray.

• macOS

• Windows

• Download page · GitHub Releases and checksums

Use it to open CloudCLI Cloud environments, switch between local and remote workspaces, and copy mobile/browser URLs. To work locally, choose Local CloudCLI in the desktop app; it will use your running local server or start one for you.

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.

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:

1. Open Tools Settings - Click the gear icon in the sidebar

2. Enable Selectively - Turn on only the tools you need

3. Apply Settings - Your preferences are saved locally

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

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.

Private Repositories