Cindy
在本机文件和已登录应用中完成任务的开源桌面与移动端 AI 助手。
这个 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 有哪些优点和局限?
- 把 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?
准备 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 相比,Cindy 将两者作为可在同一任务中切换的 harness,并保留连续的工作区、记忆、技能和工具;是否使用官方服务、自带 API key 或本地模型取决于用户的配置方式。