cleancode README

项目的 README,来自 github.com/chen-985211/cleancode。合并为一个 markdown 文件:README.md。

CleanCode CleanCode

Download latest release Native CleanCode MCP tools Workflow automation MIT License

macOS Windows Linux Discord

简体中文 · 繁體中文 · English · 한국어 · 日本語

A canvas ADE for human–AI collaboration: AI handles the complexity of learning and operating tools, so you can focus on goals, judgment, and intuitive interaction.
Work alongside Agents on one canvas, with visible progress and direct control whenever you need it.

Download CleanCode Preview (macOS / Windows / Linux)

Multiple Agents, terminal workflows, and Git branch workspaces on the CleanCode canvas

Multiple Agents and connected terminal tasks in a branch workspace.

▶ Multi-Agent Collaboration Demo (0:39)

https://github.com/user-attachments/assets/9e157258-5604-4da6-83f9-65943c19efc5

▶ Full demo (2:33, with sound)

https://github.com/user-attachments/assets/cafe373f-97b7-4f8c-b4a4-dfbc88ab26c3


🧩 What Is CleanCode?

CleanCode is a canvas ADE (Agentic Development Environment) for human–AI collaboration. It brings Agents, terminals, and project workspaces onto one canvas, so you can express intent, interact directly, and work with Agents on development and automation tasks.

Its design draws on System 1 and System 2 from Thinking, Fast and Slow: System 1 describes fast, intuitive responses, while System 2 involves focused analysis, planning, and reasoning. CleanCode applies these ideas to human–AI collaboration: people handle System 1 work, while Agents handle System 2 work.

Completing a task often means learning the software first: where to find an action, which parameters to set, and how the steps fit together. CleanCode aims to let Agents handle that learning and the steps that follow. Whether you are new to the workbench or already know it well, you can start with your goal, focus on the result, and take direct control whenever you want.

✨ Core Features

See Product Features and Quick Start for details.

View all Agents

CleanCode is built on terminals and includes launch configurations for 33 Coding Agents, with automatic detection of tools installed on your machine so you can use them in the current workspace.

Other Agents that run from the command line can also run directly in a canvas terminal, using your familiar tools and configuration.

Claude Code Codex OpenCode Gemini Cursor GitHub Copilot OpenClaw Hermes Pi Cline Goose Aider Continue Charm Kilocode Qwen Code Kimi Amp Grok Droid Antigravity Kiro Mistral Vibe MiMo Code OpenClaude OMP Devin Auggie Codebuff Autohand Code Command Code Ante Rovo Dev Any CLI Agent

Keep using the Agents you know and collaborate on one canvas.

🚀 Quick Start

If you just want to get CleanCode running, you do not need to understand every concept first. The steps below are enough.

Download the Preview

Download the installer for your platform from GitHub Releases:

[!WARNING] The current Preview is not signed with official developer certificates. Download it only from this repository's GitHub Releases, and verify the package against SHA256SUMS.txt from the same release.

Because the app has not yet completed Developer ID signing and Apple notarization, macOS will block it the first time it opens. After moving CleanCode.app to /Applications and verifying the source and SHA-256 checksum, you can remove the download quarantine attribute for this app only and launch it:

xattr -dr com.apple.quarantine /Applications/CleanCode.app
open /Applications/CleanCode.app

This command bypasses the initial Gatekeeper check for this app. Do not replace the target with a broad path such as /Applications, your Downloads folder, or your home directory. Alternatively, follow Apple's official instructions and choose Open Anyway under System Settings → Privacy & Security.

Source Development Requirements

These requirements apply only when running from source or contributing to development. You do not need to install these development dependencies before downloading the Preview.

Run Locally

git clone https://github.com/chen-985211/cleancode.git
cd cleancode
pnpm install
pnpm dev

Common Checks

pnpm typecheck
pnpm test
pnpm pre-commit

Build Locally

# Unpacked app for the current platform, intended for local verification
pnpm package

# Distribution installer for the current platform
pnpm dist

# You can also select a target explicitly on the corresponding operating system
pnpm dist:mac
pnpm dist:win
pnpm dist:linux

Build artifacts are written to release/.

📚 Documentation

🤝 Contributing

Issues, discussions, and pull requests are welcome. Before you begin, read the Contributing Guide and Development Guidelines.

💬 Join the Community

Scan the code below to join the CleanCode community, share ideas, suggest features, or report problems, and help make CleanCode better.

Scan to join the CleanCode community (group number: 186885114)

Group number: 186885114
Explore the possibilities of an AI-native operating system through human–AI collaboration.

cleancode (chen-985211/cleancode)

正在搜索数据库…

这是什么?CleanCode 是一款开源的画布式 ADE(智能体开发环境),您可以在同一个画布上排列 Claude Code、Codex 等编程智能体、终端和项目工作区,让您和智能体一起协作完成开发与自动化任务。
这是终端封装工具还是完整的桌面应用?它是一款基于终端构建的完整 Electron 桌面应用:一个可视化的画布工作台,您可以在上面排列、堆叠和分组智能体与终端面板,而不只是单一的命令行封装。
我该如何让它运行起来?从 GitHub Releases 下载适用于您平台的安装程序:macOS 使用通用版 DMG/ZIP,Windows 使用 x64 NSIS 安装程序,Linux 使用 x64 AppImage/DEB。
使用它之前,我需要先安装 Claude Code 或 Codex 吗?CleanCode 会自动检测您电脑上已安装的命令行智能体,并为其中 33 个提供启动配置,包括 Codex 和 Claude Code;其他基于命令行的智能体也可以直接在画布终端中运行。
当前版本可以直接安装吗?预览版没有使用官方开发者证书签名,因此 macOS 的 Gatekeeper 会在首次启动时拦截它。您需要先校验 SHA256 校验和,并手动移除隔离属性(或在“隐私与安全性”设置中允许运行),之后才能打开。
它在 macOS、Windows 和 Linux 上的运行方式一样吗?是的,三个平台都提供预构建安装程序:通用版 DMG/ZIP 适用于 Intel 和 Apple Silicon 芯片的 Mac,NSIS 安装程序适用于 Windows x64,AppImage/DEB 适用于 Linux x64。
什么是分支工作区?分支工作区借助 Git worktree 让您并行处理多个改动,每个分支都拥有自己的画布、终端和智能体会话。
CleanCode MCP 有什么作用?原生的 CleanCode MCP 让智能体可以直接操作画布:它们可以搭建工作流、创建其他智能体,并为它们分配任务。
这个应用为什么要这样划分人与智能体的工作?这一设计受到“系统 1 与系统 2”思维理论的启发:人负责快速、直觉式的目标设定与决策,智能体则负责较慢的分析性工作,包括学习工具、规划步骤和执行任务。
我能把工作区关联到 GitHub Issue 吗?可以,CleanCode 支持以 Issue 为驱动的开发:您可以浏览 GitHub Issues,并直接创建或打开与某个 Issue 关联的分支工作区。
有哪些类似的项目?vicoa, paseo, acryl, deer-flow, ordewell, qwen-code, bb, agent-manager
大小
17.7 MB
星标
114
更新
提交Nov 18
时长
4个月
提交 · 90 天