desktop-cc-gui

Name: desktop-cc-gui
Author: zhukunpenglinyutong

Issues

Multi-engine AI coding desktop client (Tauri). Claude Code, Codex, Gemini, OpenCode, DeepSeek Harness and more in one GUI.

4,011stars

350forks

TypeScript

Installation

# Add to your Claude Code skills
git clone https://github.com/zhukunpenglinyutong/desktop-cc-gui

Getting Started

Guides for using cli tools skills like desktop-cc-gui.

Getting Started with AI Skills
First-time install walkthrough for Claude Code, Codex CLI, and ChatGPT.
SkillsLLM Features Guide
Voting, bookmarks, comments, comparison pages, and security scanning explained.
What is an AI Skills Marketplace?
Definitions, how marketplaces work, and how to choose between them in 2026.

Security ReportIssues

Last scanned: 8/17/2026

{
  "issues": [
    {
      "type": "npm-audit",
      "message": "@chevrotain/cst-dts-gen: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@chevrotain/gast: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@excalidraw/excalidraw: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@excalidraw/mermaid-to-excalidraw: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@hono/node-server: Node.js Adapter for Hono: Path traversal in `serve-static` on Windows via encoded backslash (`%5C`)",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@mermaid-js/parser: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@xmldom/xmldom: xmldom: Uncontrolled recursion in XML serialization leads to DoS",
      "severity": "high"
    },
    {
      "type": "npm-audit",
      "message": "ajv: ajv has ReDoS when using `$data` option",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "brace-expansion: brace-expansion: Zero-step sequence causes process hang and memory exhaustion",
      "severity": "high"
    },
    {
      "type": "npm-audit",
      "message": "chevrotain: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "dompurify: DOMPurify contains a Cross-site Scripting vulnerability",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "fast-uri: fast-uri vulnerable to host confusion via literal backslash authority delimiter",
      "severity": "high"
    },
    {
      "type": "npm-audit",
      "message": "flatted: flatted vulnerable to unbounded recursion DoS in parse() revive phase",
      "severity": "high"
    },
    {
      "type": "npm-audit",
      "message": "hono: Hono: ReDoS in CORS middleware via Access-Control-Request-Headers",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "immutable: Immutable.js `List` 32-bit trie overflow → unrecoverable DoS",
      "severity": "high"
    },
    {
      "type": "npm-audit",
      "message": "ip-address: ip-address: Address4 decodes leading-zero octets as decimal while resolvers decode them as octal, allowing SSRF and trust-boundary bypass",
      "severity": "high"
    },
    {
      "type": "npm-audit",
      "message": "js-yaml: JS-YAML: Quadratic-complexity DoS in merge key handling via repeated aliases",
      "severity": "high"
    },
    {
      "type": "npm-audit",
      "message": "langium: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "lodash-es: lodash vulnerable to Code Injection via `_.template` imports key names",
      "severity": "high"
    },
    {
      "type": "npm-audit",
      "message": "mermaid: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "minimatch: minimatch has a ReDoS via repeated wildcards with non-matching literal in pattern",
      "severity": "high"
    },
    {
      "type": "npm-audit",
      "message": "nanoid: Predictable results in nanoid generation when given non-integer values",
      "severity": "high"
    },
    {
      "type": "npm-audit",
      "message": "pdfjs-dist: PDF.js: Arbitrary JavaScript execution upon opening a malicious PDF ",
      "severity": "high"
    },
    {
      "type": "npm-audit",
      "message": "picomatch: Picomatch: Method Injection in POSIX Character Classes causes incorrect Glob Matching",
      "severity": "high"
    },
    {
      "type": "npm-audit",
      "message": "postcss: PostCSS has XSS via Unescaped </style> in its CSS Stringify Output",
      "severity": "high"
    },
    {
      "type": "npm-audit",
      "message": "rollup: Rollup 4 has Arbitrary File Write via Path Traversal",
      "severity": "high"
    },
    {
      "type": "npm-audit",
      "message": "undici: undici vulnerable to downstream response desynchronization via retry interceptor",
      "severity": "high"
    },
    {
      "type": "npm-audit",
      "message": "uuid: uuid: Missing buffer bounds check in v3/v5/v6 when buf is provided",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "vite: Vite Vulnerable to Path Traversal in Optimized Deps `.map` Handling",
      "severity": "high"
    },
    {
      "type": "npm-audit",
      "message": "vitest: When Vitest UI server is listening, arbitrary file can be read and executed",
      "severity": "critical"
    },
    {
      "type": "npm-audit",
      "message": "ws: ws: Uninitialized memory disclosure",
      "severity": "high"
    },
    {
      "type": "npm-audit",
      "message": "xlsx: Prototype Pollution in sheetJS",
      "severity": "high"
    }
  ],
  "status": "FAILED",
  "scannedAt": "2026-08-17T04:40:47.280Z",
  "npmAuditRan": true,
  "pipAuditRan": true,
  "promptInjectionRan": true
}

README.md

Frequently Asked Questions

What is desktop-cc-gui?

desktop-cc-gui is an open-source cli tools skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by zhukunpenglinyutong. Multi-engine AI coding desktop client (Tauri). Claude Code, Codex, Gemini, OpenCode, DeepSeek Harness and more in one GUI. It has 4,011 GitHub stars.

Is desktop-cc-gui safe to use?

desktop-cc-gui failed SkillsLLM's automated security scan, which flagged one or more high-severity issues. Review the Security Report section carefully before using it.

How do I install desktop-cc-gui?

Clone the repository with "git clone https://github.com/zhukunpenglinyutong/desktop-cc-gui" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is desktop-cc-gui written in?

desktop-cc-gui is primarily written in TypeScript. It is open-source under zhukunpenglinyutong on GitHub, so you can review or fork the full source.

Are there alternatives to desktop-cc-gui?

Yes. SkillsLLM lists many other CLI Tools skills you can browse and compare side by side. Open the CLI Tools category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh desktop-cc-gui against similar tools.

LLM Engineer for Beginners

Ship LLM features to production - prompts, RAG, structured outputs, evaluation

39 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

ECC

by affaan-m

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

240,529

Popular in CLI Tools

Top skills in this category by stars

claude-code-templates

by davila7

CLI tool for configuring and monitoring Claude Code

30,266

claude-bug-bounty antigravity-claude-proxy

Desktop CC GUI

English · 简体中文

![][github-contributors-shield] ![][github-forks-shield] ![][github-stars-shield] ![][github-issues-shield]

ccgui is an open-source multi-engine AI coding desktop client. In plain words: it brings command-line AI coding runtimes such as Claude Code, Codex CLI, Gemini CLI, OpenCode, and DeepSeek Harness (DSH) into one graphical interface.

It is not a DSH Web UI shell and not a dsh-plugin. DSH is one of several native engines; models and API keys for DSH still live in the DSH host / Web UI, while ccgui provides the unified chat, files, Git, and project intelligence surface.

No more staring at a black terminal. Open ccgui, pick a project, and chat with AI to write code, fix bugs, and commit to Git. File and tool activity is visible as it happens; token usage and estimated cost appear when the selected runtime supplies the required metadata.

The app is built with Tauri 2 + React 19 + TypeScript + Rust and runs on macOS, Windows, and Linux. App settings, workspace indexes, and client state are persisted locally by default. Content sent to an AI provider, Browser Agent, email service, or an optional remote/web service follows the boundary of that configured service.

What can ccgui do?

One client, multiple AI engines

Registers runtime adapters for Claude Code, Codex CLI, Gemini CLI, OpenCode, and DeepSeek Harness (DSH). Gemini is enabled by default; OpenCode is optional. Their planned retirement remains an active migration, not shipped behavior.
Claude and Codex support managed provider profiles. Gemini and OpenCode retain the provider/configuration model exposed by their own runtimes.
DeepSeek Harness is a native engine (dsh-host-rpc): ccgui can adopt a running local dsh web host or start one, then create / resume / fork DSH sessions in the same GUI as the other engines. Models and credentials stay in DSH — this repo is not installable via dsh plugin add.
Sessions survive restarts: close the app and your conversation history is still there. Resume broken sessions and see how much context each one is using.

A chat box designed for coding

The input box supports @ file references, slash commands, pasted images, and attachments.
Supported file edits, shell/tool calls, and reads show up as live cards.
Claude/Codex sessions expose rewind and fork where the current runtime capability supports them.
Bad at prompts? The built-in prompt enhancer polishes them for you.
Queue follow-ups: while the AI is busy, line up your next question.

Not just chat — a full set of dev panels

File tree: browse, preview, copy, paste, rename, and drag files straight into the conversation.
Built-in terminal: a real terminal, no need to switch windows.
Git panel: stage, commit (with AI-generated commit messages), branches, worktrees, diffs, and commit history.
Global search: files, sessions, past messages, skills, and commands — one search box for everything.

Stay organized when tasks pile up

Plan panel: the AI's execution plan listed step by step, so you always know where it is.
Intent Canvas: sketch your plan on a canvas before writing any code.

Project intelligence (the part that makes ccgui different)

Project Map: the AI scans your project and builds an interactive knowledge graph — file relations, API contracts, and module dependencies at a glance, with incremental updates.
Project Memory: store key conventions and lessons, then inject selected memories with @@ or explicitly enable Memory Reference retrieval for the current turn.
Context Ledger: inspect selected or inherited context sources together with available token/character estimates, freshness, and attribution confidence.
Usage stats: inspect token, cache, and estimated-cost metadata when the runtime provides it. Monthly budget thresholds are local visual guidance; they do not interrupt the runtime.

Extensions and personalization

Discover and manage available MCP servers and Skills, and enable bundled curated skills. MCP/Plugin marketplace entries are currently Coming Soon.
Browser Agent: open policy-allowed HTTP(S) pages and collect bounded read-only context. Snapshot/navigation support can degrade by platform; element and form actions are not yet supported.
21 built-in VS Code-derived themes, plus user-message color, window transparency, and UI/code font controls.
The WebView UI ships 10 languages. The native desktop menu is localized for Chinese and English today; other locales fall back to Chinese. Composer, panel, navigation, and file-action shortcuts are configurable.
macOS / Windows / Linux, with in-app auto-update.

For what changed in each release, see CHANGELOG.md.

Download

Grab the installer for your platform from the Releases page:

Platform	Installer
macOS (Apple Silicon)	`aarch64.dmg`
macOS (Intel)	`x64.dmg`
Windows	`.exe` (NSIS)
Linux	`.AppImage`

After installing, configure your AI engine in Settings (e.g. a Claude Code API key or local CLI), add a project folder, and you're good to go.

Using DeepSeek Harness (DSH)

Install the DSH CLI on your machine (for example npm i -g @deepseek-ai/dsh, or use a local binary you already have).
Configure models and API keys in the DSH Web UI / host — not as a separate vendor preset inside ccgui.
In ccgui Settings → CLI validation / engine settings, pick DeepSeek Harness, set host/port if needed, and optionally enable auto-start of the local host.
Select DeepSeek Harness in the composer engine picker and start chatting.

ccgui is a multi-engine desktop client for DSH, not a plugin package and not a re-skinned official Web UI.

Getting it running (setup guide)

Want to build it yourself or contribute? Three steps.

Step 1: Prepare your environment

You need these three things:

Tool	Version	What for
Node.js	20 or newer	Runs the frontend
Rust	stable (install via rustup)	Compiles the backend
CMake	any recent version	Builds some dependencies

Each OS needs a bit of extra prep (these are Tauri framework requirements — see the official Tauri prerequisites):

macOS: install Xcode command line tools: xcode-select --install; get CMake via brew install cmake.
Windows: install Microsoft C++ Build Tools and WebView2 (Windows 11 ships with WebView2).
Linux: install webkit2gtk and friends — just copy the commands from the Tauri docs.

Step 2: Install dependencies

git clone https://github.com/zhukunpenglinyutong/desktop-cc-gui.git
cd desktop-cc-gui
npm install

Note: you must use npm. pnpm and yarn are blocked by a script (so everyone gets identical dependency versions).

Step 3: Start it

# macOS / Linux
npm run tauri:dev

# Windows
npm run tauri:dev:win

A few tips:

The first launch compiles the entire Rust backend and can take a few minutes — go grab a coffee. Later launches use incremental builds and are fast.
An environment self-check (doctor) runs before startup. If it fails, run npm run doctor by itself — it tells you what's missing and how to install it.
The frontend runs on port 1420. Don't worry if the port is taken; the script cleans it up automatically.
Only touching the UI, not Rust? npm run dev runs the frontend alone in a browser (backend-dependent features won't work there).

Building installers

npm run build:mac-arm64      # macOS Apple Silicon
npm run build:mac-x64        # macOS Intel
npm run build:mac-universal  # macOS Universal
npm run build:win-x64        # Windows x64
npm run build:linux-x64      # Linux x64
npm run build:linux-arm64    # Linux arm64

How to work on the code (development guide)

Tech stack at a glance

Part	Technology
UI	React 19 + TypeScript + Tailwind CSS 4
Build	Vite 7
Desktop shell	Tauri 2 (Rust backend)
Tests	Vitest (frontend) + cargo test (Rust)

Directory layout

desktop-cc-gui/
├── src/                    # Frontend code
│   ├── features/           # ★ Feature modules (50+), one folder per feature — where most work happens
│   │   ├── composer/       #    Input box
│   │   ├── messages/       #    Message stream
│   │   ├── git/            #    Git panel
│   │   ├── project-map/    #    Project knowledge map
│   │   └── ...             #    Each folder is a self-contained feature
│   ├── components/         # Shared UI components used across features
│   ├── services/           # Business logic; services/tauri/* contains frontend↔Rust wrappers
│   ├── i18n/               # 10 shipped WebView locale bundles
│   ├── styles/             # Global styles
│   └── lib/ utils/         # Utility functions
├── src-tauri/              # Rust backend
│   └── src/                # Organized by module: engine / codex / git / terminal / files ...
├── scripts/                # Build, check, and diagnostic scripts
└── docs/                   # Architecture docs, performance baselines

The typical workflow for changing a feature

UI-only change: find the matching module under src/features/ and edit there. New com