内容
<div align="center">
# Clidable
**面向所有人的 CLI 编程代理** — 为 Claude Code、Codex、Antigravity 等提供真正的终端，具有可回溯的检查点、实时预览、一键式 MCP/技能/插件以及 AI 团队。
[](https://github.com/openclide/clidable/actions/workflows/ci.yml)
[](https://github.com/openclide/clidable/releases)
[](LICENSE)
[](https://bun.sh)
[文档](docs/README.md) · [快速入门](docs/getting-started.md) · [远程 & VPS](docs/remote-vps.md) · [发布](https://github.com/openclide/clidable/releases)
</div>
---
编码代理在命令行上非常出色，但在实际使用中却很痛苦。Clidable 保留每个代理的**真正的终端（PTY 上的 TUI）**，并将其包装在一个为实际开发而构建的工作区中：每个消息前都会创建快照的检查点，您可以一键回溯，实时预览您的应用程序，以及一个管理 MCP 服务器、技能和插件的中心位置，适用于所有代理。只需一个 Bun 进程和一个端口 — 在您的桌面、浏览器或手机上。
## 安装
**Homebrew（macOS / Linux）：**
```sh
brew install openclide/tap/clidable-server
clidable-server # → http://127.0.0.1:7878
```
**或安装脚本** — 检测您的操作系统/架构，验证下载内容的校验和，安装到 `~/.local/bin`:
```sh
curl -fsSL https://raw.githubusercontent.com/openclide/clidable/main/install.sh | bash
```
所有平台（包括 Windows）的二进制文件都位于
[发布页面](https://github.com/openclide/clidable/releases)。
**从源代码** — 需要 [Bun](https://bun.sh) ≥ 1.3.13:
```sh
git clone https://github.com/openclide/clidable
cd clidable && bun install && bun run dev
```
> **设计上仅限本地访问。** Clidable 会启动终端，因此将其暴露给网络可能会导致远程代码执行 — 服务器拒绝任何非回环绑定。对于远程访问，请使用隧道或身份验证代理 — 请参阅
> [远程 & VPS 设置](docs/remote-vps.md)。
## 功能
- **真实终端中的代理** — Claude Code、Codex、Antigravity、Kimi、OpenCode、GitHub Copilot 等，每个代理都在其真正的 PTY 上的 TUI 中。从不无头，从不 JSON 流。
- **可回溯的检查点** — 私有影子-git 仓库中每个消息的前快照；一键回溯整个项目。您的真实 `.git` 仓库永远不会被触及。
- **实时预览** — Clidable 在开发服务器启动时捕获其 URL，并在终端旁边渲染您的应用程序，适用于桌面/平板电脑/手机视口。
- **MCP、技能和插件** — 一次安装，Clidable 将其投影到每个可以使用它的代理中，并保持同步的 `AGENTS.md` 文件。
- **AI 团队** — 让主代理委派给专业角色。
- **无处不在** — 原生桌面（一个 ~50-LOC Tauri shell，具有操作系统窗口光泽），任何浏览器，或移动设备上的可安装 PWA。
## 技术栈
- **Bun** — 运行时、服务器（`Bun.serve`，带有 HTML 导入）、打包器、PTY、SQLite（`bun:sqlite`）
- **React 19** + **Tailwind v4** — 前端，由 Bun 提供服务和打包（无 Vite）
- **Tauri 2** — 具有操作系统级窗口光泽的薄桌面 shell
- **TypeScript 6** — 双方
## 开发
```sh
bun install
bun run dev # Bun 服务器 + 前端，位于 http://127.0.0.1:7878（HMR）
bun run tauri:dev # 通过 Tauri（需要 Rust 工具链）进行原生窗口
bun run typecheck # 跨树的 tsc --noEmit
bun run test # 单元测试（服务器 + 共享 + 网页）
bun run build # 生产包 → dist/（自我验证）
bun run build:compile # 单文件二进制文件 → dist/clidable-server
```
请参阅 [CONTRIBUTING.md](CONTRIBUTING.md) 以获取完整的工作流程，以及
[CLAUDE.md](CLAUDE.md) 以获取架构决策和经验教训。
## 项目状态
Pre-1.0，核心体验已实现：终端 + 作曲家、检查点、代码编辑器 + 差异、项目 + 预览、技能/MCP/插件/指令管理器、AI 团队委托。路线图上：检查点保留、签名桌面包、服务器模式身份验证、移动/PWA 润色。请参阅 [PLAN.md](PLAN.md)。
## 许可证
[Apache-2.0](LICENSE) 2026 — 免费运行、阅读、分支和交付。
MCP 市场