makecindy/cindy

Consider it done. The open-source AI agent that works out of the box · 想到，就能做到。开源、开箱即用的 AI Agent。

它是什么

Cindy 是一个开源的 AI 代理，在您自己的计算机上运行，并在您的项目和应用程序中完成实际工作。它旨在“开箱即用”——第一天就准备好，但随着时间的推移可自定义。

核心概念

Cindy 将多个 harness（底层代理引擎）、模型和工具组合成一个代理。首批支持的 harness 是 Claude Code 和 Codex，计划支持更多，并正在开发原生 harness。模型和 harness 可以自由混合，并在任务中途切换，而您的工作区、记忆、技能和工具保持连续。单个任务甚至可以由运行在不同 harness × 模型组合上的代理进行规划、并行执行和审查。Cindy 还可以驱动您的浏览器、计算机和手机，并从即时消息和日程中获取工作。

此仓库中的内容

此仓库是 Cindy 的开源客户端——桌面和移动应用及其共享包，组织为 pnpm monorepo：

路径	描述
`apps/desktop`	Electron 桌面客户端
`apps/mobile`	Expo / React Native 移动客户端
`packages/*`	共享客户端功能（认证、设备链接、代理编排、模型提供商等）
`apps/*-bin`	随桌面应用发布的工具二进制文件（按平台下载，不提交）

后端服务位于单独的仓库中，不属于此 monorepo。

模型与账户

您可以通过多种方式引入模型：

登录官方 Cindy 服务 — 使用量透明扣除
授权您已付费的 Claude Code / Codex 编码计划，并在 Cindy 中继续使用 — 无需重复付费
连接您自己的 API 密钥
使用本地模型

有两种使用模式：

模式	账户要求	可用性
托管服务	Cindy 云账户	完整托管服务，定价见 cindy.app
跳过登录	无需 Cindy 登录	仅本地代理；服务器支持的功能不可用

自定义（“由您塑造”）

记忆 — 纠正她一次，她就会一直做对，跨 harness 共享
技能 — 教一次工作方式，随处重用；团队共享正在开发中
自动化 — 重复性工作自行安排、自行运行、自行报告
MCP — 将您的内部工具和业务系统接入她的能力范围
插件 — 重塑功能、UI 和交互，通过开放市场共享 （正在开发中）
源代码 — 审计、分叉、扩展，并在 Apache-2.0 下贡献改进

隐私与遥测

官方分发构建包含 TapDB 使用分析，用于汇总统计（设备标识符、操作系统/应用版本、启动和活动事件）。登录后，事件与您的账户 ID 关联，因此并非完全匿名。TapDB 不收集聊天内容、文件内容或工作目录数据。

您可以禁用使用分析而无需编辑代码：桌面 → 设置 → 关于 → 使用统计；移动 → 设置中的使用统计。偏好默认开启。

其他要点：

桌面在禁用时立即停止报告；本地模式（跳过登录）完全不向 TapDB 报告
移动在禁用时立即取消账户关联并停止显式报告
在线心跳和诊断日志是单独的机制，不受使用统计开关影响
桌面原生崩溃转储保留在本地，从不自动上传
从源代码构建：桌面开发构建默认不初始化 TapDB；移动在没有注入 TapDB 配置的情况下不初始化

入门（开发）

先决条件： 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

开发入口点：

pnpm restart:desktop:remote --region=cn      # 中国大陆 Cindy 账户
pnpm restart:desktop:remote --region=global  # 全球 Cindy 账户

远程开发使用您自己的 Cindy 云账户和现有登录状态。客户端默认连接到 Cindy 的官方云服务——外部开发者无需自托管服务器。

贡献与许可证

贡献通过拉取请求进入 main
每个提交都需要 开发者原始证书 签署（git commit -s）；DCO 检查强制执行，无需 CLA
代码采用 Apache-2.0 许可证（仓库根目录的 LICENSE 管辖；单个文件不包含头）
模型权重、数据集、提示、商标和其他单独标识的材料可能有自己的许可条款
根据 SECURITY.en.md 私下报告安全问题——切勿公开问题