App Cindy 开箱即用的跨平台 AI 智能体助手

很多 AI 助手要么只在浏览器里、要么只会聊天、要么把你的文件和数据传到别人服务器。真正“开箱即用”的代理，应该能直接操作你本机的文件、浏览器、手机，能接你已经在用的编码工具（Claude Code、Codex），还能在任务中途换模型而不丢上下文。市面上的产品要么太轻、要么太重、要么锁死在某个云端。

Cindy 想做的是“开箱即用、又不被锁死”的那一类。它由 makecindy 维护，客户端以 Apache-2.0 开源，桌面端用 Electron、移动端用 Expo / React Native，本体跑在你自己机器上，用你的真实文件与已登录的 App。首批接入的 harness 是 Claude Code 与 Codex，原生 harness 也在路上。

项目基本信息

一、项目介绍

Cindy 把自己定义为“开箱即用的开源 AI 智能体”。它把多个 harness、多个模型、多个工具收进同一个代理，在你的项目和 App 里完成真实工作。关键是“第一天就能用，之后随你塑造”：模型与 harness 可以自由混用，任务中途也能切换，而你的工作区、记忆、技能与工具始终保持连续；甚至可以让一个任务由“不同 harness × 不同模型”组合来规划、并行执行、再评审。

它还能驱动你的浏览器、电脑与手机，从即时消息与日程里接活儿。仓库本身是开源客户端：桌面与移动 App 加共享包，组织成 pnpm 单仓。后端服务在独立仓库，不在此 mono-repo 内。当前客户端版本为 v0.1.115。

二、核心优势

第一，不被锁死。开源意味着可审计、可 fork、可在 Apache-2.0 下贡献改进。模型随你带：登录官方 Cindy 服务（用量透明扣减）、用你已付费的 Claude Code / Codex Coding Plan（不重复计费）、自带 API key，或用本地模型。

第二，记忆跨 harness 共享。纠正一次，它就一直做对，且在不同 harness 间共享，避免“换工具就失忆”。

第三，技能可沉淀。把一种工作方法教一次，处处复用；团队共享技能也在推进中。

第四，自动化与扩展。周期性工作自己排程、自己跑、自己汇报；可接 MCP 把内部工具与业务系统纳入触达范围；插件通过开放市场重塑功能与交互。

三、适用场景

适合“想让代理真正动起来、又不肯把所有数据交去云端”的个人与团队。典型用法：让 Cindy 在本地项目里改代码、跑测试、发版；在手机上从 IM 接需求；跨 harness 组合完成“规划—执行—评审”。

对开发者，这个仓库是贡献客户端的地方：桌面、移动、共享包都在这，能从源码构建并关闭内置分析。对企业，可用官方云服务拿到完整托管能力，或走 Skip Sign-In 仅用本地代理。

四、安装教程

从源码构建需要 Node.js 22.x、pnpm 10.x（暂不支持 v11）与 Git LFS。克隆并安装：

git clone https://github.com/makecindy/cindy.git
cd cindy
git lfs pull
pnpm install

常见报错与处理：

error: Git LFS is required

没装或没拉取 LFS 对象。先装 Git LFS，再 git lfs pull；缺它会让部分二进制缺失。

pnpm: ERR_PNPM_UNSUPPORTED_ENGINE (Node 22 required)

当前 Node 不是 22.x。用 nvm 之类切到 22；注意 pnpm 10 才兼容，v11 暂不支持。

install failed: pnpm version mismatch

确认 pnpm -v 为 10.x。版本不对会导致依赖树异常，建议按仓库要求锁定。

普通用户更推荐直接去 cindy.app/download 下载桌面/移动安装包，免构建。登录页选 "Skip Sign-In" 即可只用本地代理，此时服务器背书的增强能力不可用，但本地 agent 照常工作。

五、使用示例

开发态重启桌面端（区分区域）：

# 中国大陆账号
pnpm restart:desktop:remote --region=cn

# 全球账号
pnpm restart:desktop:remote --region=global

这会复用你自己的 Cindy 云账号与会话，方便在开发客户端的同时延续已有对话。

普通使用则更简单——打开 App，用 Claude Code 或 Codex 作为 harness，然后像对同事一样交代任务：

把 src/utils 里的日期函数补上单元测试，
跑通后提交，并给我一句变更摘要。

Cindy 会在本机拉起对应 harness，读写真实文件，跑测试，最后回一句摘要。因为它跨 harness 共享记忆，下次你说“还是按上次那套风格”，它不会忘记。

六、常见问题

问：数据会离开我的机器吗？
答：本地代理模式下不会。官方分发版含 TapDB 聚合统计（设备/系统/版本元数据，登录后关联账号 ID），不收集聊天、文件或工作目录内容；构建时可去掉。登录云账号时仅发送心跳（账号 ID、平台、版本）。

问：能用我自己的模型吗？
答：能。可登录官方服务、用已购 Coding Plan、自带 API key，或接本地模型，四种方式任选。

问：Skip Sign-In 是连本地服务器吗？
答：不是。它只是不用 Cindy 账号跑本地代理，App 显示"未登录"，服务器背书能力不可用，但本地 agent 正常工作。

问：后端开源吗？
答：本仓库是客户端（Apache-2.0）；后端服务在独立仓库，不在此 mono-repo。

七、总结

Cindy 主打“开箱即用又不被锁死”：开源客户端跑在本机，多 harness、多模型、跨设备，记忆与技能可沉淀，MCP 与插件可扩展。协议 Apache 2.0。若你想要一个能真正动你文件、又能随时换模型、还能从源码审计的代理，Cindy 值得一试；普通用户直接下安装包，开发者从 pnpm install 起步。