desktop-cc-gui README

The project's README from github.com/zhukunpenglinyutong/desktop-cc-gui. As one markdown file: README.md.

Desktop CC GUI

ccgui icon

English · 简体中文

zhukunpenglinyutong%2Fdesktop-cc-gui | Trendshift

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

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. Streaming output, thinking traces, and tool calls are visible as they happen; token usage appears when the engine reports it.

The app is built with Tauri 2 + React 18 + TypeScript + Rust and runs on macOS, Windows, and Linux. Settings and state are persisted locally. Content sent to an AI provider follows the boundary of the channel you configured for that CLI.

What can ccgui do?

One client, seven AI engines

A chat box designed for coding

Not just chat — a full set of dev panels

Plugin system

Settings, network, and updates

Download

Grab the installer for your platform from the Releases page:

Platform Installer
macOS (Apple Silicon, signed) aarch64.dmg
Windows .exe (NSIS)
Linux .AppImage

After installing, open Settings, configure a provider channel for the CLI you want (or sign in), add a project folder, and start chatting.

Using DeepSeek Harness (DSH)

  1. Install the DSH CLI on your machine and configure its models and API keys in DSH itself — not as a separate vendor preset inside ccgui.
  2. In Settings → DeepSeek Harness, ccgui can adopt a running local dsh web host or auto-start one.
  3. Select DeepSeek Harness in the composer engine picker. Chat runs through DSH's headless profile; models and credentials stay in DSH.

Getting it running (setup guide)

Want to build it yourself or contribute? Three steps.

Step 1: Prepare your environment

Tool Version What for
Node.js 20 or newer Runs the frontend toolchain
pnpm 10 (pinned via packageManager) Installs dependencies
Rust stable (install via rustup) Compiles the backend

Each OS also needs the standard Tauri prerequisites — see the official Tauri guide:

Step 2: Install dependencies

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

Note: this is a pnpm workspace (the plugin SDK lives in packages/plugin-sdk); the lockfile is pnpm-lock.yaml.

Step 3: Start it

pnpm dev

A few tips:

Building installers

pnpm build:mac                 # macOS signed build (scripts/build-signed-macos.sh)
pnpm build:mac:skip-notarize   # same, skipping notarization

Windows and Linux installers are produced by the CI workflows under .github/workflows/ (release.yml, build-windows-artifact.yml).

How to work on the code (development guide)

Tech stack at a glance

Part Technology
UI React 18 + TypeScript + Tailwind CSS 4 + zustand
Build Vite 6
Desktop shell Tauri 2 (Rust backend: git2, rusqlite, portable-pty, axum)
Tests Vitest (frontend) + cargo test (Rust)

Directory layout

desktop-cc-gui/
├── src/                    # Frontend code
│   ├── features/           # ★ Feature modules: chat / files / git / terminal /
│   │                       #   settings / plugins / commands / update / open-app
│   ├── components/         # Shared UI components (incl. engine brand icons)
│   ├── i18n/               # zh + en locale bundles
│   ├── styles/             # Global styles
│   └── lib/ utils/         # Utility functions
├── src-tauri/              # Rust backend
│   └── src/                # engine/ (one module per CLI), history/, plugins/,
│                           # git.rs, terminal.rs, web.rs (LAN bridge), ...
├── packages/plugin-sdk/    # @ccgui/plugin-sdk — plugin authoring kit
├── tests/                  # Frontend integration-style tests (Vitest)
├── scripts/                # Build and packaging scripts
└── docs/                   # Plugin development guide, engine mode notes

The typical workflow for changing a feature

  1. UI-only change: find the matching module under src/features/ and edit there. New components live inside that feature's own folder.
  2. Needs backend support: add a #[tauri::command] in the matching src-tauri/src/ module and call it from the frontend via the Tauri API.
  3. Changed any UI text: route it through i18n and keep both bundles (src/i18n/zh.ts, src/i18n/en.ts) synchronized — hardcoded UI text is not allowed.

Everyday commands

Command What it does
pnpm dev Start the full app (Tauri dev mode)
pnpm build TypeScript check + frontend production build
pnpm test Run the Vitest suite
pnpm preview Preview the production frontend build
cargo test --manifest-path src-tauri/Cargo.toml Run Rust tests

Writing tests

Coding rules

Not many rules, but each exists for a reason:

  1. Run the big three before opening a PR: pnpm build (typecheck) and pnpm test green locally, plus cargo test if you touched Rust.
  2. UI text must go through i18n: every user-visible string comes from src/i18n/, and both shipped locale bundles must stay synchronized.
  3. Keep components close to home: new components start inside their own feature folder; promote to src/components/ only once they're genuinely reused across features.
  4. TypeScript strict: don't paper over things with any; write real types.
  5. Extend through the plugin SDK where possible: new settings sections and surfaces should register through the same extension points the builtin ones use.
  6. Never commit secrets: API keys and tokens must never appear in code or commit history.

Writing commit messages

Use Conventional Commits with a Chinese action phrase by default: type(scope): 中文动宾短句.

type When to use
feat New feature
fix Bug fix
refactor Refactoring (no behavior change)
docs Documentation
test Adding/updating tests
chore Housekeeping (version bumps, deps, scripts)
perf / style / ci Performance / formatting / CI

Real examples from this repo:

feat(chat): 支持工具调用参数与结果展开、Git Diff/Bash美化及完成元数据展示
fix(codex): Windows .cmd shim 下多行提示词只送达第一行
perf(chat): reveal streamed text per frame without reparsing markdown

No emoji in commit messages, and no AI-generated signatures.

Submitting your code (contribution flow)

  1. Fork the repo and clone it locally.
  2. Branch off main, named like feat/xxx or fix/xxx.
  3. Make your changes and get pnpm build + pnpm test green locally.
  4. Open a PR against this repo's main branch. Title in commit format; in the description, explain what changed, why, and how you verified it.

Not sure where to start? Browse the Issues and pick one that interests you. Found a bug or have an idea? Open an issue and let's talk.

Want to dig deeper?

License

MIT

Thanks for the support and feedback from the friends at LINUX DO.

Contributors

Thanks to all the contributors who help make ccgui better.

Contributors

Acknowledgements

This project originally started from CodexMonitor. Since v1.0.0 the codebase has been rewritten from scratch — no CodexMonitor code remains, but the original inspiration is gratefully acknowledged.

Star History

Star History Chart

desktop-cc-gui (zhukunpenglinyutong/desktop-cc-gui)

Searching Database…

4.5K ·GitHub
Desktop-cc-gui
Что это такое?ccgui — десктопный GUI, который собирает консольные ИИ-инструменты для кодинга (Claude Code, Codex CLI, Kimi CLI, Grok CLI, Pi CLI, OMP CLI и DeepSeek Harness) в одном графическом интерфейсе: вы общаетесь с ИИ-агентом, чтобы писать код, править баги и коммитить в Git, вместо того чтобы пялиться в голый терминал.
Это сам агент для кодинга или просто обёртка над другими CLI?У ccgui нет собственного ИИ-движка — это десктопная оболочка на Tauri + React, которая регистрирует адаптеры для существующих CLI-инструментов вроде Claude Code и Codex CLI и позволяет выбирать, какой движок работает в каждой сессии чата.
Как его запустить?Возьмите готовый установщик для своей ОС со страницы Releases (macOS .dmg, Windows .exe через NSIS или Linux .AppImage), затем откройте Settings, чтобы настроить канал провайдера или выполнить вход для нужного CLI.
Нужно ли отдельно устанавливать сами ИИ-CLI?Для большинства движков каналы провайдеров записываются прямо в нативные конфиги каждого CLI внутри ccgui. Исключение — DeepSeek Harness (DSH): DSH CLI вы устанавливаете сами и там же настраиваете модели и API-ключи, а ccgui подключается к запущенному или автозапущенному DSH web-хосту.
На каких операционных системах он работает?ccgui поставляется в подписанных сборках для macOS (Apple Silicon), Windows (.exe через NSIS) и Linux (.AppImage).
Куда уходят мои данные чатов и код?Настройки и состояние сессий хранятся локально на вашей машине, а всё, что вы отправляете ИИ-провайдеру, остаётся в границах канала, настроенного для конкретного CLI, — отдельного серверного хранилища учётных данных у ccgui нет.
Что входит в панели разработки помимо чата?Помимо чата, ccgui включает виртуализованное дерево файлов с цветами Git-статуса и встроенный редактор CodeMirror, настоящий терминал на базе PTY (xterm + WebGL), панель Git для индексации, коммитов и просмотра диффов, а также командную палитру, управляемую с клавиатуры.
Можно ли расширять ccgui плагинами?Да — официальный SDK для плагинов (@ccgui/plugin-sdk) позволяет плагинам добавлять разделы настроек и UI, описываемый конфигом, через те же точки расширения, что использует встроенное приложение, без поставки собственного фронтенд-кода.
Можно ли зайти в ccgui с другого устройства в моей сети?Да, функция веб-доступа по LAN отдаёт интерфейс другим устройствам через WebSocket-мост с аутентификацией по токену, а в Settings есть QR-код для быстрой привязки.
Откуда взялся этот проект?Изначально ccgui вырос из проекта под названием CodexMonitor, но с версии v1.0.0 кодовая база полностью переписана с нуля — от прежнего осталась только изначальная идея.
What are similar projects?cocode, ai-manager, zuse, acryl, monocode, qwen-code, skills-manager, shipyard
Which topics is it in?vibe-coding, ai-coding, tauri, dsh, harness, deepseek-harness, git, gemini, sdk, coding-agent, rust, codex
Creator
zhukunpenglinyutong
Size
209.9 MB
Stars
4.5K
Updated
CommitOct 15Releasev1.1.4Oct 15
Age
8mo
Commits · 90 Days