很多 AI 助手停在“聊天框”里,要它真正在电脑上干活——读文件、开浏览器、连手机、按日程自动跑任务——要么得自己拼一堆脚本,要么被锁在某个闭源服务里。Cindy 的设想是:一个开源、开箱即用的 AI 代理,把多个 harness、模型与工具收进一个能在本机完成真实工作的代理,且随时可被你改写。

项目基本信息

信息项详情
项目名称cindy
GitHub地址https://github.com/makecindy/cindy
项目描述开源开箱即用的AI代理,在本机完成真实工作并可由你自由塑造
作者makecindy
开源协议Apache License 2.0
开源状态公开
LanguagesTypeScript
支持平台Windows / macOS / Linux
最后更新2026-10-25

一、项目介绍

Cindy 是一个开源、开箱即用的 AI 代理,把多个 harness、模型与工具融合进一个能在你的项目和应用中完成真实工作的代理。本仓库是其开源客户端(Electron 桌面 + Expo/React Native 移动端 + 共享包,pnpm monorepo)。首次支持 Claude Code 与 Codex 两类 harness,更多正在加入;模型与 harness 可自由混用,任务中途也能切换,而工作区、记忆、技能、工具保持连续。

二、核心优势

  • 开箱即用:装好即能驱动浏览器、电脑、手机,从 IM 与日程接任务。
  • 可被塑造:记忆、技能、自动化、MCP、插件均可由你改动并共享。
  • 模型自由:登录官方 Cindy 服务、复用已有 Claude Code/Codex 计划、自带 API Key 或本地模型均可。
  • 跨端:桌面与移动端同源,工作连续。
  • 透明计费:用官方服务时用量清晰可查,复用已有计划不重复扣费。

三、适用场景

  • 个人把日常电脑操作、文件处理、信息检索交给代理。
  • 团队共享技能与自动化流程。
  • 需要代理跨设备(桌面 / 手机)协同。
  • 想基于开源客户端二次开发定制 UI 与插件。

四、安装教程

依赖: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 报版本不符,切到 10.x;Git LFS 未拉取会导致资源缺失,记得 git lfs pull;Linux 参考官方 Ubuntu/Arch/Omarchy 安装指南。

五、使用示例

启动桌面端开发(中国大陆账号):

 pnpm restart:desktop:remote --region=cn

全球账号:

 pnpm restart:desktop:remote --region=global

输出:打开桌面客户端即可登录并继续既有会话,代理在本机执行文件、浏览器、手机等任务。

六、常见问题

  • 必须登录官方服务吗?可“Skip Sign-In”用本地代理,但部分云端能力不可用。
  • 数据隐私?官方构建含聚合用量统计(不含聊天/文件内容);自编译可去除。
  • 支持中文吗?提供简体中文文档与客户端区域选项。

七、总结

Cindy 把“能在本机干真实活的 AI 代理”做成了开源、可塑的形态,既开箱即用又不设围墙。Apache-2.0 协议,适合既想要强能力、又坚持可审计可改写的用户与团队。