命令行编码智能体 artec/clat

CLAT

cl + at = command-line agent · 主页

CLAT 是一个本地优先的编码智能体底座，以 Rust 单二进制交付。它可以检查仓库、编辑文件、执行命令、调用外部工具并持久化会话，不要求用户另外安装 JavaScript 或 Python 运行时。
这条承诺针对 CLAT 自带核心；用户自行配置的 MCP server 与 DSH adapter 可以声明自己的运行时要求。

项目以真实仓库 dogfood 为起点，把反复出现的需求沉淀为可复用、模型无关的能力。

CLAT 桌面工作台

快速开始

在当前仓库打开终端界面。
clat

首次进入后运行 /model，选择预设并填写 API key。

无头调用：位置参数是指令，管道输入是上下文。
clat exec "用一句话解释这个仓库"
git diff | clat exec "审查这个 diff"

不需要凭据，离线验证 模型 -> 工具 -> 模型 循环。
clat demo

检查是否有通过签名验证的升级。
clat upgrade --check

完整命令行参数见 clat --help。

界面内置英文、简体中文和繁体中文，默认跟随系统。可用 clat --lang zh-Hans --help、TUI 的 /language 或工作台语言选择器切换。
详见语言设置。

使用界面

| 界面 | 适用场景 | 入口 |
| 终端 UI | 日常交互式仓库开发 | clat |
| 无头运行器 | 脚本、CI、git hook、编辑器集成 | clat exec |
| Web 工作台 | 可安装的本地 PWA 与 HTTP+SSE 客户端 | clat serve |
| 原生桌面 | 自带后端、独立升级的 macOS/Windows 应用 | 桌面客户端 |
| 微信远程控制 | 官方 iLink 文本、图片、插话与审批 | clat serve --im wechat |
| DSH 客户端 | 用 CLAT TUI 连接本地 DeepSeek Harness 宿主 | clat dsh |
| 插件管理器 | 浏览签名市场，安装、更新、审计或回滚插件包 | clat plugin / pi.at.cn |
| 离线演示 | 无凭据验证核心循环 | clat demo |

从 v2.1.2 起，发布签名集中到一个 latest.json；此前的 CLI/Desktop 用户需手动重装一次，再使用内置升级。

桌面本地调试使用 bun start，生成本机测试安装包使用 bun app:build。
桌面开发与发布脚本由 Bun 直接执行 TypeScript，无需 Python。
桌面启动时恢复上次打开且仍受信任的项目；项目失效时回到欢迎页并显示恢复提示。
正式发布时，推送签名标签后即可运行 ./publish，与 CI 构建重叠进行。
Windows 安装包复用同平台 CLI；macOS 桌面包复用 CI 后端，在本机编译、签名和公证，中断后可复用已完成阶段。

clat serve 默认只绑定 127.0.0.1:2691，并自动用默认浏览器打开响应式 PWA。本地通过 Host/Origin/Fetch Metadata 三查后无感进入；远程 authority 必须持有效凭据。浏览器只保存私有 HttpOnly 会话，凭据不进入 URL。使用 --no-open 可关闭自动打开浏览器。
桌面首发起，同一 Release 同时提供 CLI 压缩包和桌面安装包。
桌面与 CLI/PWA 共用 Host 数据，各自独立更新；无需预装 CLI、Node.js 或 Python。
Windows 当前通过 GitHub 面向开发者和进阶用户分发；安装包尚无 Windows 发布者签名，可能出现安全提示或被设备策略阻止。面向普通用户、由商店管理更新的 Microsoft Store 版仍在规划中，尚未上线。详见桌面分发渠道。
可选的微信前端只走官方 iLink；必须显式扫码绑定、配对用户，并以带 --im wechat 的 serve 启动，否则保持关闭。

已包含的能力

- 智能体工作流——无固定轮次上限的 模型 → 工具 → 模型 循环、运行中插话、向用户提问、每会话 todo、自动标题，以及保留原始日志的上下文压缩。
- 工作流智能——持久化 Plan Mode 与结构化工具过滤，bundled/user/project 三层 Markdown skills 的惰性有界加载，可选的用户级只读 LSP 导航（definition、references、implementation、hover，经 CLAT 管理的沙箱 stdio），以及 /context 一次性解释模型实际可见上下文的估算分项。
- 有界 Agent 智能——不允许模型写入的显式 project/user 本地记忆；每会话一个带 CAS 的持久 goal 及仅由用户显式开启的有界续跑；默认关闭、深度 1 的 explorer/reviewer 实验，子 Agent 只拥有三个项目相对只读工具。
- 模型——DeepSeek、GLM、Qwen、Kimi、腾讯混元内置预设，命名自定义档案， OpenAI Responses 与 OpenAI 兼容协议，思考/用量/缓存/上下文/配额遥测；经探针验证的视觉路由支持结构化 TUI 图片草稿、多路径选择、显式剪贴板导入、纯图片消息与运行中图片插话。
- 原生工具——有界且理解 gitignore 的字面量/正则/glob 搜索、文件列表与读取、按模型能力门控的视觉检查、原子写入、精确编辑、单文件多 hunk 补丁，以及支持增量输出、stdin、 PTY 和受管进程组清理的 run 级命令会话。macOS 在 Full Access 之外使用功能探测过的 Seatbelt 写入/网络强制隔离；Windows 使用 restricted-token ACL 沙盒，如实报告部分写隔离、读取与网络开放；Linux 报告受监督 fallback；成功文件工具触及嵌套路径后，会刷新对应作用域的项目指令。
- 权限——Read Only、Project Write、Full Access 三档，审批时完整参数审查； macOS/Windows 的 Project Write 原生命令绑定实际沙盒后免审；项目信任、路径围栏，以及无头场景的失败关闭。
- 会话——~/.clat 下可从崩溃恢复的追加式 DSH 兼容日志、本地 replay 与按项目恢复当前会话。
- 扩展——stdio / Streamable HTTP MCP、沙箱化 WebAssembly 组件，以及面向 DSH 可移植插件能力的静态 Cordis 兼容适配器；同一个事务型插件管理器安装 WASM 与可执行 MCP 包，并提供签名市场发现、依赖求解、发布者/撤销校验、能力复审与回滚。
- 前端中立核心——TUI、无头运行器、本地服务和可选微信前端共享同一个 Application 门面、权限管道、附件 admission 与事件词汇。默认情况下 clat 会发现或启动一个 127.0.0.1:2691 上的后台宿主，终端 UI 与 Web 工作台可同时在线使用同一批会话；clat standalone 保留传统进程内 TUI。

安装

macOS / Linux：

curl -fsSL https://raw.githubusercontent.com/artec/clat/main/install.sh | sh

Windows（PowerShell）：

irm https://raw.githubusercontent.com/artec/clat/main/install.ps1 | iex

安装器优先使用预编译发行产物，没有对应产物时回退源码构建。预编译覆盖 macOS arm64 / x86_64、Windows x86_64 / arm64，以及 glibc 2.39+ 的 Linux x86_64 / aarch64。更老的 Linux 可用稳定版 Rust 工具链源码构建。信任模型与平台基线见发布签名。

预编译版本在 macOS/Linux 安装到 ~/.local/bin/clat，在 Windows 安装到 %LOCALAPPDATA%\clat\bin\clat.exe；PATH 未包含该目录时安装器会给出提示。源码回退使用 Cargo 的 bin 目录，通常是 ~/.cargo/bin。卸载时删除对应可执行文件即可；~/.clat 用户状态会保留，除非你另行删除。

文档

从与你当前任务最接近的文档开始：

| 目标 | 文档 |
| 使用 TUI、exec、serve 或 dsh | CLAT 使用指南 |
| 安装并更新原生桌面版 | 桌面客户端 |
| 选择界面语言与维护翻译 | 多语言 |
| 配置预设或自定义模型 | 模型编辑器 |
| 理解审批、权限档位与路径边界 | 权限 |
| 配置 MCP server | MCP 集成 |
| 搜索与抓取公开网页 | 原生联网工具 |
| 搜索与检视会话历史 | 会话检索 |
| 后台任务 | Host 所有的命令、输出、取消与恢复 |
| 定时与续跑 | 明确授权、有界 Job 续跑、时间规则与恢复 |
| 使用 DSH 官方 web 搜索与抓取 | Web 工具 |
| 在 PWA 或 CLI 安装和管理插件 | CLAT 插件 |
| 安装或编写 WASM 组件 | WASM 插件 |
| 了解 WASM 网络协议与交付 | 网络协议与交付 |
| 移植 DSH/Cordis 插件 | DSH 插件兼容指南 |
| 审核有运行时证据的 DSH 兼容声明 | DSH 兼容证据矩阵 |
| 理解核心边界与生命周期 | 架构 |
| 理解 Provider 适配与重试 | Providers |
| 理解文件、会话日志与恢复 | 持久化状态 |
| 构建和发布版本 | 发布签名 |
| 运行带真实凭据的冒烟验证 | 真实模型验证 |

DSH 适配器包另有独立的英文和包文档。

开发

日常编辑用 scripts/gates.sh [test-filter ...] 获取定向反馈；负责人开始发布准备时，再运行一次 scripts/gates.sh --full。见测试分级。

前置条件只有 Git 与当前稳定版 Rust 工具链：

git clone https://github.com/artec/clat.git
cd clat
cargo test --all-targets --all-features
cargo build
./target/debug/clat demo

常用仓库路径：

| 路径 | 用途 |
| src/ | Rust 核心与各前端 |
| web/ | clat serve 内嵌的零构建 Web 资源 |
| wit/ | WASM 插件契约 |
| schemas/ | 插件/包的机器可读 schema |
| sdk/clat-plugin/ | WASM 插件作者使用的 Rust SDK |
| sdk/dsh-adapter/ | DSH 插件作者使用的 npm 适配器 |
| plugins/ | WASM 示例与试点插件 |
| market/ | 可独立部署的 pi.at.cn 目录与签名索引发布工具 |

真实 Provider 检查不会进入常规测试套件，因为它需要用户凭据且可能产生费用。Provider 行为在改动范围内时，请按真实模型验证执行。贡献者和编码智能体还应阅读项目宪法 AGENTS.md。

原则

本地优先 · 单一二进制 · 模型无关 · MCP 原生 · 项目感知 · 权限优先 · Dogfood 驱动 · 泛化而非特化。

许可证

MIT