Cindy
在本机文件和已登录应用中完成任务的开源桌面与移动端 AI 助手。
- Star 数
- ★ 2.8k
- 最近更新
- 3 天前
- License
- Apache-2.0
- 主语言
- TypeScript
- FA 评分
- 52/100 · 缺口较多
30 秒速览
- 可在哪里用
- 兼容但需适配Codex · Claude Code
- 开始前需要
- 典型场景
- 已经订阅 Claude Code 或 Codex Coding Plan 的开发者,希望在同一客户端内继续使用现有授权并在任务中切换 harness。
- 主要局限
- 本仓库仅包含客户端;后端服务位于独立仓库,无法据此仓库自行部署完整服务端。
- 源码审查
- 52/100 · 缺口较多
这个 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 安排和汇报重复性工作。
- 已经订阅 Claude Code 或 Codex Coding Plan 的开发者,希望在同一客户端内继续使用现有授权并在任务中切换 harness。
- 需要让本机助手处理项目文件和已登录应用的个人或团队成员。
- 希望将内部业务系统通过 MCP 接入任务流程的组织。
- 需要把周期性工作安排为自动执行并接收结果汇报的运营人员。
- 需要同时使用桌面端与移动端 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?
查看各维度的扣分理由
证据显示:README 明确说明默认连接官方云服务,并披露了遥测(TapDB)和心跳数据,但未提供用户确认机制或数据流可视化。依赖安全方面,package.json 有 overrides 和 patchedDependencies,CI 中验证子模块来源,但未提供依赖漏洞扫描证据。外部影响方面,README 提到可驱动浏览器、电脑和手机,但未说明权限控制。回滚方面,未提及。来源归属方面,有 DCO 和贡献指南,但发布者未验证。扣分原因:缺少用户确认、最小权限和回滚的具体实现证据。
证据显示:CI 配置了多平台测试(Linux/Windows)和分片,但未提供测试结果或覆盖率。依赖可用性方面,有 pnpm 锁文件和 overrides,但未提供依赖可用性保证。失败消息方面,未提供具体错误处理示例。扣分原因:静态审查无法验证测试执行,失败消息证据不足。
证据显示:README 描述了多种使用场景(桌面、移动、浏览器、IM),并说明了能力边界(本地运行、支持 Claude Code 和 Codex)。触发精度方面,未提供具体触发机制。环境适配方面,支持多平台和 Node 版本要求。扣分原因:触发精度证据不足。
证据显示:README 提供了清晰的架构说明和文档索引,安装步骤明确,许可证为 Apache-2.0,有贡献指南。命名稳定性方面,未提供版本历史。示例和 FAQ 方面,README 有基本示例但无 FAQ。已知限制方面,README 提到部分功能在制作中。版本变更日志方面,未提供。维护责任方面,有 SECURITY.md 和贡献指南。扣分原因:缺少版本变更日志和 FAQ。
证据显示:README 描述了输出能力(完成任务、报告),但未提供具体输出示例。边际价值方面,强调开源、可定制,但未与其他工具对比。成本效益方面,提到免费使用和自带模型,但未提供详细成本分析。扣分原因:输出可用性证据不足。
证据显示:README 中的声明部分有文档支持(如架构、安全),但未提供独立验证。跨来源佐证方面,未提供外部引用。事实与推断分离方面,README 区分了事实和计划,但未明确标注。扣分原因:缺乏独立验证和外部佐证。
- 默认连接官方云服务,需注意数据隐私和网络依赖。
- 遥测数据虽不包含聊天内容,但会关联账户 ID,需用户知情。
- 依赖下载自第三方,虽有 SHA256 校验,但需确保供应链安全。