CloudCode

CloudCode is a local AI CLI unified management platform. It provides a web UI and local daemon for managing the full lifecycle of AI coding CLI tools — version management, provider/model switching, MCP server configuration, skills management, and system prompts.

What CloudCode does

• Version management: detect, install, upgrade, and uninstall AI CLI tools (Claude CLI, Codex CLI, Gemini CLI, Cursor CLI, and more via adapters).
• Provider / model management: configure multiple API endpoints and keys, switch active providers, sync across all managed CLIs.
• MCP server management: unified CRUD for MCP servers, per-app enable/disable, auto-sync to each CLI's native config.
• Skills management: single source of truth skill repository, install/uninstall/enable/disable, sync to CLI skill directories.
• System prompt management: manage prompt presets, cross-app format adaptation (CLAUDE.md, AGENTS.md, GEMINI.md).
• Run execution (deferred priority): route prompts to local CLI workers and stream output via SSE.

What CloudCode is not (yet)

• A cloud-hosted orchestration platform.
• A replacement for git hosting or CI systems.
• A full distributed job scheduler.

Core differentiator

Unlike CLI-only tools, CloudCode provides a Web UI management panel as the primary interface. Unlike desktop-only tools, CloudCode runs as a lightweight local daemon accessible from any browser. The config sync engine translates CloudCode's unified configuration into each CLI's native format automatically.

Supported CLI tools

CLI	Status
Claude CLI	Supported
Codex CLI	Supported
Gemini CLI	Supported
Cursor CLI	Supported
Custom	Extensible via adapter interface

Tech stack

• Backend: Rust (axum)
• Frontend: Vite + React + TypeScript + Tailwind CSS
• Storage: local files under ~/.cloudcode/, SQLite when justified
• Streaming: SSE

Local file layout

~/.cloudcode/
  config.json              # CloudCode config (port, theme, etc.)
  state/
    cli_tools.json         # Detected CLI tools and versions
    providers.json         # Provider configurations
    mcp_servers.json       # MCP server configurations
    prompts.json           # Prompt presets
    workspaces.json        # Workspaces (preserved)
  credentials/             # API keys and secrets
  skills/                  # SSOT skill repository
  logs/                    # Run logs
  backups/                 # Config backups
  cache/                   # Version check cache, etc.

Quickstart

Backend:

cargo run -- init
cargo run -- start

Frontend:

make web

Open the Vite URL (default http://127.0.0.1:5173) to access the CloudCode management panel.

Desktop:

make desk

Mobile placeholders:

make android
make ios

Validation guidance:

• make check for static validation
• make test for Rust test execution
• make verify-local for the default local validation command set
• docs/testing/ for canonical validation rules and reporting expectations

Repository transition:

• The repo now includes a shared contracts crate at crates/cloudcode-contracts/.
• The repo now includes a transitional dedicated server crate at apps/server/.
• The repo now includes an independent desktop shell at apps/desktop/ with src-tauri/.
• The web app now lives at apps/web/.
• The repo now includes reserved mobile surfaces at apps/mobile/android/ and apps/mobile/ios/.
• This is the first migration step toward separate server and desktop Rust applications with shared core crates.
• The desktop UI is intentionally separate from the web dashboard UI; only contracts and lower Rust layers are candidates for sharing at this stage.
• The normalized dev entrypoints are make server, make web, make desk, make android, and make ios.

Documentation

• Goals
• Roadmap
• Architecture
• Tech Stack
• Storage Model
• CLI Commands
• CLI Adapter Model
• Web UI
• Desktop Shell
• Mobile Surfaces
• Development Guide
• Testing Docs

Current phase

CloudCode is in Phase 0 (foundation and scaffolding). See Roadmap for details.