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 | Русский | Українська
Cowork in Action · Why Choose CLonUI? · Quick Start · Community
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 |
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
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.
Output: editable Morph PPT (
.pptx) Morph-animated slide-to-slide transitions with coherent story pacing.
Output: editable Word (
.docx) Paper/thesis writing and production-ready document editing via thedocxskill.
Output: usable Excel (
.xlsx/.xlsm/.csv) Generate/refresh spreadsheets withxlsxfor analysis, auto-formatting, and charts.
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
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.
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.
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.
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.
Already using Claude Code, Codex, or Hermes Agent? CLonUI auto-detects them and pulls them into the same unified Cowork workspace.
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 testSee CONTRIBUTING.md for the full development guide, architecture overview, and coding conventions.
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 e2eUse 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.
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 |
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
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.
| 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 |
- GitHub Discussions — ask questions and share what you build: https://github.com/YassinAliYassin/CLonUI/discussions
- Issues — report bugs or request features: https://github.com/YassinAliYassin/CLonUI/issues
- Built by SolidAI — a sovereign LLM platform for African businesses and communities.
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.
