Cindy：把 Claude Code 与 Codex 变成可编排的本地 AI Agent
一个把 Claude Code、Codex 和本地工具放进桌面与手机的 AI Agent，记住工作方式还能自动执行任务。
GitHub makecindy/cindy 更新 2026-10-25 分支 main 星标 4.1K 分叉 588
TypeScript Electron Expo / React Native Claude Code Codex MCP 本地 AI Agent pnpm monorepo

🧭 决策指南

为什么现在热： 无法从材料判断。可确认的信号是 README 展示了 Claude Code、Codex、MCP、Memory、Automation 和本地 agents，同时 2026-10-25 当日新增 477 颗星、总星数 4,106，最新版本为 v0.1.115。

适合，如果你

  • 你想在 Electron 桌面端和 Expo / React Native 移动端共用 Agent 工作流。
    README 的 “What's in this repo” 列出 apps/desktop、apps/mobile 和 packages/*。
  • 你已经在使用 Claude Code 或 Codex Coding Plan，希望在 Cindy 中继续使用。
    README 正文说明可授权已有的 Claude Code / Codex Coding Plan，且无需重复付费。
  • 你需要用 MCP 连接内部工具，并让 Memory、Skills、Automation 跨 harness 复用。
    README 的 “Yours to shape” 章节列出 Memory、Skills、Automation 和 MCP。
  • 你希望先不登录 Cindy 账户，在本机运行 local agents。
    README 的 “Skip Sign-In” 模式说明无需 Cindy sign-in，并在本地运行 agents。

不适合，如果你

  • 你必须自托管后端服务，而不是连接 Cindy 官方云端。
    README 明确说明 backend service 位于独立仓库，不在这个 monorepo 中；客户端默认连接官方云服务。
  • 你只接受完全关闭官方分发版的分析与在线心跳。
    README 的 “Privacy & telemetry” 说明官方构建包含 TapDB，登录后发送在线 heartbeat。
  • 你的开发环境只能使用 pnpm v11 或 Node.js 22.x 之外的版本。
    README 的 “Prerequisites” 要求 Node.js 22.x、pnpm 10.x，并注明 v11 尚不支持。
  • 你依赖已完成的插件开放市场或团队 Skills 分发。
    README 将 Plugins 的 open marketplace 和 Skills 的 team sharing 标记为 “in the making”。

前置条件

  • Node.js 22.x
  • pnpm 10.x（v11 尚不支持）
  • Git LFS
  • Git；安装依赖时 pnpm install 会按平台下载 claude-code、codex 和 ripgrep
  • 若构建 Android Windows 包，需要在打包前获取固定版本且经 sha256 校验的 Android platform-tools

第一步命令（README 原文）

git clone https://github.com/makecindy/cindy.git

要注意

  • 不要把 Skip Sign-In 当成本地服务端；README 明确说它运行 local agents，server-backed capabilities 不可用。
    README 的 “Skip Sign-In” 说明。
  • 远程桌面开发要显式选择 --region=cn 或 --region=global，不应依赖 internal default。
    README 的 “Development entry points” 章节提供两条 pnpm restart:desktop:remote 命令，并要求不要依赖 internal default。
  • 源码构建可关闭 TapDB，但移动端需不注入 clientId / clientToken，桌面端需移除 initTapdb()。
    README 的 “Privacy & telemetry” 章节说明 apps/mobile/src/analytics/mobileTapdb.ts 和 apps/desktop/src/renderer/index.tsx 的处理方式。
  • SkillHub 同时存在 skillhubApiBaseUrl 与 cindySkillHubApiBaseUrl，当前客户端不会回退到旧字段。
    README 的 “Skill Hub migration” 说明两个 manifest 字段及当前客户端行为。

替代方案

  • Claude Code：只需要 Claude Code harness，不需要 Cindy 的 Memory、MCP、移动端和多 harness 编排时。
    README 正文的 “The first supported harnesses are Claude Code and Codex”
  • Codex：只需要 Codex harness，且不需要 Electron、Expo / React Native 客户端整合时。
    README 正文的 “The first supported harnesses are Claude Code and Codex”

材料未说明

  • README 未说明支持的完整桌面与移动操作系统版本。
  • README 未说明 Claude Code、Codex、API key 与本地模型的具体兼容矩阵。
  • README 未给出 Cindy hosted service 的具体价格、配额和 usage deduction 规则。
  • README 未说明独立 backend 仓库的地址、部署步骤和自托管许可。
  • README 未提供 Memory、Skills、Automation 在复杂任务中的性能或可靠性数据。
  • README 未说明 Android platform-tools 固定版本的具体版本号。

💡 深度解析

6
适合 我负责同时修改 Electron 桌面端和 Expo/React Native 移动端，开发环境可以安装 Node.js 22.x、pnpm 10.x 和 Git LFS；这个仓库是否适合作为贡献入口？
适合读者： 准备从源码贡献 Electron 桌面端和 Expo/React Native 移动端的 TypeScript 开发者，开发机需要遵守固定 Node.js 与 pnpm 版本

适合，因为仓库就是包含桌面端、移动端和共享包的 pnpm monorepo，且 README 给出了明确的贡献环境。具体条件是：

  • apps/desktop 使用 Electron，apps/mobile 使用 Expo / React Native。
  • packages/* 共享认证、设备连接、Agent 编排和模型提供商等能力，适合跨端修改。
  • 环境必须是 Node.js 22.x、pnpm 10.x；README 明确写明 pnpm 11 尚不支持，并要求 Git LFS。
  • 远程开发需要按账号区域选择 cn 或 global，且默认连接官方云服务；后端不在本仓库内。
  • What's in this repo：apps/desktop — Electron desktop client
  • What's in this repo：apps/mobile — Expo / React Native mobile client
  • What's in this repo：packages/* — Shared client capabilities
  • Prerequisites：Node.js 22.x；pnpm 10.x（v11 is not yet supported）；Git LFS
git lfs pull
材料未说明：README 摘要未列出桌面端和移动端各自完整的验证命令。；README 未说明当前移动端功能与 Electron 桌面端的功能对齐程度。；README 未说明贡献者是否必须获得额外的云账号或内部访问权限。
适合 我希望审计并二次开发一个以 TypeScript 为主的 AI 客户端，要求桌面端、移动端和设备工具链都能检查，且项目代码采用 Apache-2.0；这个仓库是否适合作为分叉基础？
适合读者： 希望审计并二次开发开源 AI 客户端、同时要求固定依赖来源和 Apache-2.0 许可的 TypeScript 工程师

适合，尤其适合作为客户端层的审计和分叉基础；但它不是完整 Cindy 服务的自包含源码。依据如下：

  • 项目主语言是 TypeScript，仓库结构覆盖 Electron 桌面端、Expo/React Native 移动端和共享 packages。
  • README 明确源代码采用 Apache-2.0，并鼓励 audit、fork、extend。
  • claude-code、codex、ripgrep 等桌面工具按平台下载，Android platform-tools 在 Windows 打包前固定版本并做 SHA-256 校验，便于检查供应链入口。
  • 后端服务不在仓库中，官方服务端点和自动更新默认指向 Cindy 基础设施，因此分叉客户端不等于获得完整自托管产品。
  • README 原句：Source — audit, fork, extend, and contribute improvements back under Apache-2.0
  • 项目数据：main_language 为 TypeScript；license 为 Apache License 2.0
  • What's in this repo：apps/desktop、apps/mobile、packages/*
  • What's in this repo：tool binaries are downloaded per platform；Android platform-tools pinned and sha256-verified
pnpm install
材料未说明：README 摘要未列出所有第三方依赖、模型权重和工具二进制的独立许可证。；README 未说明移除官方服务端点后，客户端哪些功能仍可独立运行。；README 未说明如何替换默认自动更新、SkillHub 和模型供应商基础设施。
适合 我已经在使用 Claude Code Coding Plan 和 Codex Coding Plan，主要维护 TypeScript 项目；如果我希望在同一个任务中切换两种 Agent，同时保留工作区、记忆和工具状态，Cindy 是否适合？
适合读者： 已经购买 Claude Code 或 Codex Coding Plan、希望在真实代码项目中切换模型与 Agent 框架的 TypeScript 开发者

适合，因为 README 明确把 Claude Code 和 Codex 作为首批支持的 Agent harness，并支持在任务中途切换。具体依据包括：

  • 模型与 harness 可以自由组合，切换时 workspace、memory、skills 和 tools 保持连续。
  • 同一任务可由不同 harness × model 组合进行规划、并行执行和复核。
  • 可以授权已有的 Claude Code / Codex Coding Plan，README 明确说明无需重复付费。
  • 但其他 Agent 框架尚未列为当前支持范围；不同框架的权限和上下文行为也可能不同。
  • README 原句：The first supported harnesses are Claude Code and Codex
  • README 原句：Models and harnesses mix freely and can switch mid-task while your workspace, memory, skills and tools stay continuous
  • README 原句：authorize the Claude Code / Codex Coding Plan you already pay for and keep using it inside Cindy — no duplicate bill
pnpm restart:desktop:remote --region=global
材料未说明：README 未说明 Claude Code 与 Codex 在中途切换时具体哪些上下文格式可以完全互通。；README 未说明现有 Coding Plan 的全部权限、限额和计费边界。
视情况 我在 macOS 或 Windows 上处理含内部代码和已登录浏览器会话的项目，不能把工作目录直接交给第三方平台；我可以跳过 Cindy 登录并继续使用本地 Agent 吗？
适合读者： 要求代码、浏览器会话和本地文件尽量不离开工作电脑、但仍想使用 Agent 自动化的 macOS 或 Windows 开发者

视情况：Cindy 支持不登录 Cindy 账号运行本地 Agent，但这不是完整的自托管模式，也不能因此获得服务器能力。需要注意：

  • 登录页选择“Skip Sign-In”后，应用状态显示为“Not signed in”，可使用本地 agents。
  • Server-backed capabilities 在该状态不可用；本仓库也不包含后端，后端位于独立仓库。
  • README 说明 Cindy 使用本机真实文件和已登录应用，适合本地工作流，但实际隐私边界还取决于所选模型、Agent 和工具。
  • 官方客户端默认连接 Cindy 云服务，桌面自动更新也来自官方 CDN，因此严格隔离环境可能不符合要求。
  • README 原句：Skip Sign-In ... to use local agents; Server-backed capabilities are unavailable
  • README 原句：Cindy runs locally on your own machine, using your real files and logged-in apps
  • What's in this repo：the backend service lives in a separate repository
  • README 原句：the client connects to Cindy's official cloud services by default
git clone https://github.com/makecindy/cindy.git
材料未说明：README 未说明每个本地 Agent 的数据是否会调用外部模型服务。；README 未说明跳过登录模式下浏览器会话、文件内容和工具调用的完整数据流。；README 未提供完整自托管后端部署步骤。
视情况 我们已经有内部工具和业务系统，希望通过 MCP 接入 Cindy，并让 Agent 按周期执行任务和反馈结果；在后端不属于本仓库的前提下，我能否把它当作完整的企业自动化平台？
适合读者： 需要把内部业务系统接入 Agent、并通过周期任务处理企业流程的小型团队工程师

视情况：客户端具备 MCP、Skills 和周期自动化的产品方向，但本仓库不能单独提供完整企业平台，尤其不能替代独立的云端后端与组织治理能力。依据包括：

  • README 列出 MCP，可将内部工具和业务系统接入 Agent。
  • Automation 支持 recurring work、自动运行和结果反馈；Skills 可沉淀可复用流程，团队共享仍在建设中。
  • 本仓库明确是 desktop/mobile client，backend service 位于独立仓库。
  • 官方服务、账号、区域路由、权限、自动更新和数据策略不由本仓库单独覆盖，因此企业上线所需的审计、审批和回滚能力仍需另行确认。
  • Yours to shape：Automation — recurring work schedules itself, runs itself, reports back
  • Yours to shape：MCP — wire your internal tools and business systems into her reach
  • Yours to shape：handing Skills to your team is in the making
  • What's in this repo：the backend service lives in a separate repository
材料未说明：README 未说明 MCP 的认证、权限粒度、写入操作审批和失败重试机制。；README 未说明周期任务的调度精度、并发限制和执行日志保留策略。；README 未说明独立后端的企业 SSO、审计和数据驻留能力。
适合 我在 Windows、macOS 或 Linux 上处理项目，也需要让 Agent 操作 iOS 或 Android 手机；如果我希望从同一个客户端延续工作区和设备连接，Cindy 是否适合？
适合读者： 同时使用 Windows、macOS 或 Linux 桌面与 iOS/Android 手机、希望让 Agent 操作真实设备的跨设备用户

适合，但跨设备能力仍受各平台权限和实现差异影响。README 与项目数据显示：

  • 项目提供 Electron 桌面客户端和 Expo / React Native 移动客户端，主题明确包含 Windows、macOS、iOS、Android 和 Linux 场景。
  • Cindy 可以驱动 browser、computer 和 phone，并能从即时通信与日程入口接收工作。
  • 共享 packages 包含 device-link 和 Agent orchestration，有利于复用设备连接与编排逻辑。
  • Android platform-tools 会按固定版本获取并进行 SHA-256 校验；但 README 没有保证不同系统在后台运行、权限和自动化能力上完全一致。
  • What's in this repo：Electron desktop client；Expo / React Native mobile client
  • README 原句：She can drive your browser, computer and phone, and take work from IM and schedules
  • What's in this repo：Android platform-tools binaries are fetched (pinned version, sha256-verified)
  • 项目数据 topics：android、ios、macos、windows、react-native、electron
pnpm install
材料未说明：README 未说明 iOS 与 Android 当前可执行的具体设备操作范围。；README 未说明移动端后台任务、设备配对和断线恢复的行为。；README 未说明 Linux 桌面端与 Windows/macOS 在电脑控制能力上的差异。

✨ 核心亮点

  • Claude Code 与 Codex 可在同一任务中切换
  • Memory、Skills 和 Automation 支持持续复用
  • MCP 可接入内部工具和业务系统
  • 同时提供 Electron 桌面端与 Expo 移动端
  • 官方客户端默认连接 Cindy 云服务
  • Apache-2.0 开源，仓库已有 4,106 颗星

🔧 工程化

  • 桌面端用 Electron，移动端用 Expo / React Native，共享 packages 编排 Agent。
  • 支持本地文件、登录应用、浏览器、电脑和手机操作。
  • Skip Sign-In 可运行本地 agents，但不提供服务端能力。
  • 可接入自有 API key、Claude Code / Codex Coding Plan 或本地模型。

⚠️ 风险

  • 后端服务不在本仓库，完整云端能力依赖 Cindy 官方服务。
  • Skip Sign-In 状态下，server-backed capabilities 不可用。
  • 官方分发包含 TapDB，登录后发送账户心跳数据。
  • 项目要求 Node.js 22.x 与 pnpm 10.x，pnpm v11 尚不支持。
  • 插件市场仍在建设中，团队 Skills 共享也尚未完成。

👥 适合谁？

  • 需要在桌面与手机间复用 Claude Code、Codex 工作流的开发团队。
  • 使用 TypeScript、Electron 或 Expo / React Native 的客户端开发者。
  • 希望通过 MCP 接入内部系统并保留本地文件访问的用户。
  • 能接受 Cindy 云服务默认端点，或只使用本地 agents 的个人开发者。