Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

CLonUI - Cowork with AI Agents

License   Platform   Open Source

A free, open-source Cowork app with AI Agents.
Built-in Agent | Zero Setup | Any API Key | Multi-Agents | Remote Access | Cross-Platform | 24/7 Automation

English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Español | Português | Türkçe | Русский | Українська


📋 Quick Navigation

Cowork in Action · Why Choose CLonUI? · Quick Start · Community


Cowork — AI Agents That Work Alongside You

CLonUI is more than a chat client. It's a Cowork platform where AI agents work alongside you on your computer — reading files, writing code, browsing the web, and automating tasks. You see everything the agent does, and you're always in control.

Traditional AI Chat Clients CLonUI (Cowork)
AI can operate on your files Limited or No Yes — built-in agent with full file access
AI can execute multi-step tasks Limited Yes — autonomous with your approval
Remote access from phone Rarely WebUI + Telegram / Lark / DingTalk / WeChat
Scheduled automation No Cron — 24/7 unattended
Multiple AI Agents at once No Claude Code, Codex, Qwen Code, Hermes Agent, Snow CLI, Cursor Agent and 13+ more — auto-detected, unified interface
Price Free / Paid Free & Open Source

Built-in Agent — Install & Go, Zero Configuration

CLonUI ships with a complete AI agent engine. Unlike tools that require you to install CLI agents separately, CLonUI works the moment you install it.

  • No CLI tools to install — the agent engine is built in
  • No complex setup — paste any API key to get started
  • Full agent capabilities — file read/write, web search, image generation, MCP (Model Context Protocol) tools
  • Ready-to-use assistants — 21 built-in professional assistants (Cowork, PPT Creator, Word Creator, Word Form Creator, Excel Creator, Morph PPT, Morph PPT 3D, Pitch Deck Creator, Dashboard Creator, Academic Paper Writer, Financial Model Creator, and more) ready to use immediately

Office assistants — PPT, Word & Excel

These tracks ship with the app: Morph PPT presets and the pptx / docx / xlsx skills (see assistant/ presets and skills/ in the repo). Want document/table output? CLonUI's document skills help PPT (Morph), Word (.docx), and Excel (.xlsx/.xlsm/.csv) go from request to deliverable faster and more reliably. The three assistant types map to file workflows, and the final outputs are directly editable and reusable.

PPT assistant

Output: editable Morph PPT (.pptx) Morph-animated slide-to-slide transitions with coherent story pacing.

Word assistant

Output: editable Word (.docx) Paper/thesis writing and production-ready document editing via the docx skill.

Excel assistant

Output: usable Excel (.xlsx/.xlsm/.csv) Generate/refresh spreadsheets with xlsx for analysis, auto-formatting, and charts.


Multi-Agent Mode — Already Have CLI Agents? Bring Them In

If you already use Claude Code, Codex, Hermes Agent, or OpenClaw, CLonUI auto-detects them and lets you Cowork with all of them — alongside the built-in agent.

Supported Agents: Built-in Agent (zero setup) • Claude Code • Codex • Qwen Code • Goose AI • OpenClaw • Augment Code • CodeBuddy • Kimi CLI • OpenCode • Factory Droid • GitHub Copilot • Qoder CLI • Mistral Vibe • Nanobot • Snow CLI • Hermes Agent • Cursor Agent and more

  • Auto Detection — automatically recognizes installed CLI tools
  • Unified Interface — one Cowork platform for all your AI agents
  • Parallel Sessions — run multiple agents simultaneously with independent context
  • MCP Unified Management — configure MCP (Model Context Protocol) tools once, automatically sync to all agents — no need to configure each agent separately
  • YOLO Mode (auto-approve all agent actions without manual confirmation) / Full-Auto Mode — one click to bypass permission prompts; all agents support full-auto mode for unattended execution

Team Mode — Coordinated Multi-Agent Collaboration

Leader orchestrates a team of sub-agents: it assigns tasks, tracks progress, and aggregates results. CLonUI ships with a built-in team runtime so you can split large jobs across specialized agents without leaving the app.


Why Choose CLonUI?

CLonUI turns a plain command-line AI agent into a friendly, modern desktop companion — and then layers a full feature set on top:

  • Cowork, not just chat — agents act on your machine with your permission.
  • Zero-setup built-in agent — no separate CLI to install; paste a key and go.
  • Any model, any provider — bring your own API key for OpenAI, Anthropic, Google, OpenRouter, or a local endpoint.
  • Remote control — drive your agents from your phone via the WebUI or Telegram.
  • 24/7 automation — schedule recurring tasks with the built-in cron engine.
  • Cross-platform — native builds for macOS, Windows, and Linux, plus a mobile companion.

🚀 Quick Start

1. Download & Install

Build the latest installer for your platform from source (see Build from Source below), or grab a release from the Releases page once published. macOS, Windows, and Linux installers are provided.

2. Launch & Add a Key

Open CLonUI, drop in any LLM API key (or point it at a local model), and start chatting. The built-in agent is ready immediately — no extra setup.

3. (Optional) Connect Your Favorite CLI Agents

Already using Claude Code, Codex, or Hermes Agent? CLonUI auto-detects them and pulls them into the same unified Cowork workspace.


🛠️ Build from Source

CLonUI is a Bun monorepo (Electron desktop + web + CLI packages).

# install dependencies
bun install

# run the desktop app in dev mode
bun run dev

# build installers for the current platform
bun run build

# run tests
bun run test

See CONTRIBUTING.md for the full development guide, architecture overview, and coding conventions.

Development

bun install         # install dependencies (frozen lockfile: bun install --frozen-lockfile)
bun run dev         # run the desktop app in dev mode
bun run webui       # run the web UI host
bun run lint        # oxlint
bun run format:check  # oxfmt formatting gate
bun run typecheck   # tsc --noEmit (via just push)
bun run test        # vitest unit suite
bun run test:e2e    # Playwright e2e

Use just push before pushing (runs lint → format-check → typecheck → test → push). prek replicates the exact CI pipeline locally. See justfile and .github/workflows/README.md.

Environment variables

Configuration is primarily managed through the app UI and local config; select environment variables are honored for specific modes:

Variable Purpose
CLONUI_MULTI_INSTANCE 1 enables multi-instance dev mode
NODE_ENV production for webui:prod prod-mode builds
Provider / MCP keys API keys are stored via the app's local database; see SECURITY.md for how secrets are handled

Repository layout

packages/
  desktop/        Electron desktop application
    src/process/    Main process (no DOM APIs)
    src/renderer/   Renderer (no Node.js APIs)
    src/preload/    IPC bridge (only boundary between the two)
  web-host/       Web rendering host (WebUI / remote UI)
  web-cli/        clonui-web CLI for headless / server use
  shared-scripts/ Shared build & release scripts
mobile/           Mobile companion (if enabled)
scripts/          Dev, build & release helpers
docs/             Architecture, contributing and guides
tests/            Unit, integration, contract, e2e and bench tests

Roadmap

Planned and ongoing work (see docs/ and the issue tracker for details):

  • Team mode & multi-agent collaboration — coordinated multi-agent workflows.
  • Web CLI / headless & remote UI — server-side usage beyond the desktop app.
  • Mobile companion — broaden the surface beyond macOS/Windows/Linux installers.
  • Security hardening — trust boundaries with MCP/remote agents and secrets handling.

📦 What's Inside

Package Purpose
@clonui/desktop The Electron desktop application
@clonui/web-host Web rendering host used by the WebUI / remote UI
@clonui/web-cli clonui-web CLI for headless / server use
@clonui/shared-scripts Shared build & release scripts

🌍 Community & Support


📜 License

CLonUI is released under the Apache License 2.0.

Copyright © SolidAI. This project is based on the AionUi open-source project (Copyright © iOfficeAI), licensed under Apache-2.0.

About

CLonUI — a free, open-source Cowork app with AI Agents. Built-in agent, zero setup, any API key, multi-agent, remote access, cross-platform.

Resources

Code of conduct

Contributing

Security policy

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages