Cindy

在本机文件和已登录应用中完成任务的开源桌面与移动端 AI 助手。

Star 数
★ 2.8k
最近更新
3 天前
License
Apache-2.0
主语言
TypeScript

30 秒速览

可在哪里用
兼容但需适配Codex · Claude Code
开始前需要
Node.js 22.xpnpm 10.xGit LFSShell / 命令行网络访问本地文件系统MCP Server
典型场景
已经订阅 Claude Code 或 Codex Coding Plan 的开发者,希望在同一客户端内继续使用现有授权并在任务中切换 harness。
主要局限
本仓库仅包含客户端;后端服务位于独立仓库,无法据此仓库自行部署完整服务端。

这个 Agent 能做什么,适合哪些场景?

Cindy 是一个开源 AI Agent 客户端,包含 Electron 桌面应用、Expo/React Native 移动应用以及共享包,采用 pnpm monorepo 组织。它在用户自己的机器上运行,可使用真实文件和已登录的应用。当前明确支持 Claude Code 与 Codex 两种 harness,并允许在任务中切换 harness 与模型,同时保持工作区、记忆、技能和工具连续。仓库还描述了浏览器、电脑和手机控制,以及从即时通信和日程接收工作;服务端后端不包含在本仓库中。用户可登录官方 Cindy 服务,也可在登录页选择“Skip Sign-In”运行本地 agent,但此模式没有服务端能力。

Cindy 客户端将 Claude Code、Codex、模型与工具接入同一任务环境,在本机文件和已登录应用中执行工作。一个任务可由不同 harness × model 组合进行规划、并行执行和审查,工作区、memory、skills 与 tools 保持连续。桌面端位于 apps/desktop,移动端位于 apps/mobile,共享能力位于 packages/*,其中 README 明确列举 auth、device-link、agent orchestration 与 model providers。它还可通过 MCP 接入内部工具和业务系统,并支持由 Automation 安排和汇报重复性工作。

  1. 已经订阅 Claude Code 或 Codex Coding Plan 的开发者,希望在同一客户端内继续使用现有授权并在任务中切换 harness。
  2. 需要让本机助手处理项目文件和已登录应用的个人或团队成员。
  3. 希望将内部业务系统通过 MCP 接入任务流程的组织。
  4. 需要把周期性工作安排为自动执行并接收结果汇报的运营人员。
  5. 需要同时使用桌面端与移动端 Cindy 客户端的用户。

如何安装或部署这个 Agent?

准备 Node.js 22.x、pnpm 10.x 和 Git LFS,然后执行:

git clone https://github.com/makecindy/cindy.git
cd cindy
git submodule update --init --recursive cindy-protocol
git lfs pull
pnpm install

仓库说明公共检出只需初始化 cindy-protocol 子模块。要进行远程开发并使用官方服务,需要自己的 Cindy 云账号及已有登录状态。

如何使用这个 Agent?

中国大陆 Cindy 账号使用:pnpm restart:desktop:remote --region=cn。其他地区账号使用:pnpm restart:desktop:remote --region=global。登录后可继续已有会话;也可在登录页选择“Skip Sign-In”运行本地 agents,此时应用显示“Not signed in”,且服务端能力不可用。README 未提供可独立调用的公共 HTTP API、SDK 调用示例或本地服务端启动命令。

这个 Agent 有哪些优点和局限?

优点
  • 把 Claude Code 与 Codex 作为首批 harness 集成到同一任务环境,并明确支持任务中切换 harness 与模型。
  • 桌面 Electron 与 Expo/React Native 移动客户端共享 auth、device-link、agent orchestration 和 model providers 等能力。
  • 可选择官方服务、已有 Claude Code/Codex Coding Plan 授权、自带 API key 或本地模型。
  • 明确提供 Skip Sign-In 本地 agent 路径,且支持通过 MCP 接入内部工具和业务系统。
局限
  • 本仓库仅包含客户端;后端服务位于独立仓库,无法据此仓库自行部署完整服务端。
  • Skip Sign-In 模式下服务端能力不可用,功能范围会缩小。
  • 从源码构建需要 Node.js 22.x、pnpm 10.x、Git LFS 和 cindy-protocol 子模块;pnpm v11 尚不受支持。
  • 默认连接官方云服务与官方 CDN,远程开发依赖 Cindy 云账号和既有登录状态。
  • 插件开放市场和团队共享技能仍标注为 in the making。

这个 Agent 与同类方案有什么区别?

与单独使用 Claude Code 或 Codex 相比,Cindy 将两者作为可在同一任务中切换的 harness,并保留连续的工作区、记忆、技能和工具;是否使用官方服务、自带 API key 或本地模型取决于用户的配置方式。

与相关度最高的同类 agent 并排比较关键指标。

Agent 源码审查 Star 最近更新 主语言 完整支持的平台
Cindy 当前 52 · 缺口较多 ★ 2.8k 3 天前 TypeScript Codex · Claude Code
MyAgents 57 · 缺口较多 ★ 896 5 天前 TypeScript Codex · Claude Code · Claude API
Memmy — 个人AI代理与本地记忆中枢 42 · 缺口较多 ★ 2k 今天 TypeScript Codex · Claude Code · OpenAI API
COMPASS Skills(司南) 85 · 表现良好 ★ 735 28 天前 Python Codex · Claude Code

FollowAgents 如何评估这个 Agent?

FollowAgents 源码审查 · FARS-2.1
缺口较多
52/ 100 五分制 2.6 / 5
信任安全 14/29
可靠稳定 8/14
适用触发 10/18
规范维护 10/18
有效结果 7/13
证据核验 3/8
查看各维度的扣分理由
信任安全14 / 29 · 2.4/5

证据显示:README 明确说明默认连接官方云服务,并披露了遥测(TapDB)和心跳数据,但未提供用户确认机制或数据流可视化。依赖安全方面,package.json 有 overrides 和 patchedDependencies,CI 中验证子模块来源,但未提供依赖漏洞扫描证据。外部影响方面,README 提到可驱动浏览器、电脑和手机,但未说明权限控制。回滚方面,未提及。来源归属方面,有 DCO 和贡献指南,但发布者未验证。扣分原因:缺少用户确认、最小权限和回滚的具体实现证据。

可靠稳定8 / 14 · 2.9/5

证据显示:CI 配置了多平台测试(Linux/Windows)和分片,但未提供测试结果或覆盖率。依赖可用性方面,有 pnpm 锁文件和 overrides,但未提供依赖可用性保证。失败消息方面,未提供具体错误处理示例。扣分原因:静态审查无法验证测试执行,失败消息证据不足。

适用触发10 / 18 · 2.8/5

证据显示:README 描述了多种使用场景(桌面、移动、浏览器、IM),并说明了能力边界(本地运行、支持 Claude Code 和 Codex)。触发精度方面,未提供具体触发机制。环境适配方面,支持多平台和 Node 版本要求。扣分原因:触发精度证据不足。

规范维护10 / 18 · 2.8/5

证据显示:README 提供了清晰的架构说明和文档索引,安装步骤明确,许可证为 Apache-2.0,有贡献指南。命名稳定性方面,未提供版本历史。示例和 FAQ 方面,README 有基本示例但无 FAQ。已知限制方面,README 提到部分功能在制作中。版本变更日志方面,未提供。维护责任方面,有 SECURITY.md 和贡献指南。扣分原因:缺少版本变更日志和 FAQ。

有效结果7 / 13 · 2.7/5

证据显示:README 描述了输出能力(完成任务、报告),但未提供具体输出示例。边际价值方面,强调开源、可定制,但未与其他工具对比。成本效益方面,提到免费使用和自带模型,但未提供详细成本分析。扣分原因:输出可用性证据不足。

证据核验3 / 8 · 1.9/5

证据显示:README 中的声明部分有文档支持(如架构、安全),但未提供独立验证。跨来源佐证方面,未提供外部引用。事实与推断分离方面,README 区分了事实和计划,但未明确标注。扣分原因:缺乏独立验证和外部佐证。

风险与缓解建议
  • 默认连接官方云服务,需注意数据隐私和网络依赖。
  • 遥测数据虽不包含聊天内容,但会关联账户 ID,需用户知情。
  • 依赖下载自第三方,虽有 SHA256 校验,但需确保供应链安全。
证据充分度: 评估于 2026年8月9日 审查版本 e1003963d67f 评估后仓库已有新提交,评分可能未覆盖最新改动
查看完整评分方法 →

常见问题

必须注册 Cindy 账号吗?
不必须。登录页可选择“Skip Sign-In”运行本地 agents;不过应用会显示“Not signed in”,且服务端能力不可用。
可以继续使用已有的 Claude Code 或 Codex Coding Plan 吗?
可以。README 说明可授权已付费的 Claude Code / Codex Coding Plan 在 Cindy 内使用,不产生重复账单。
能否自行部署完整 Cindy 服务?
该仓库没有包含后端服务;README 仅说明客户端默认连接官方 Cindy 云服务,因此没有提供完整后端自托管流程。
官方发行版会收集哪些遥测数据?
README 说明官方发行版包含 TapDB 聚合使用分析,涵盖设备、操作系统和应用版本;登录后会关联账号 ID。其说明不会收集聊天内容、文件内容或工作目录数据,崩溃转储不会自动上传。
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关 Agents