Cindy 是一个开源、开箱即用的 AI Agent 客户端项目，核心目标是在用户自己的电脑和移动设备上连接多种大模型、Agent harness 和工具，帮助完成真实工作。该仓库是 Cindy 的开源客户端，包含 Electron 桌面端、Expo/React Native 移动端以及共享 TypeScript 包，后端服务不在本仓库中。它支持官方云服务、本地模式、Claude Code、Codex、用户自带 API Key、本地模型等多种使用方式，并计划支持插件、MCP、自动化任务、团队技能共享等能力。
适用领域
AI Agent / 大模型应用 / 桌面客户端 / 移动端应用 / 开发者工具 / 自动化办公 / 多模型编排 / 跨平台应用 / Electron / React Native / TypeScript Monorepo
配置难度
中高。普通用户可以通过官方下载使用，但如果从源码构建和参与开发，需要熟悉 TypeScript、pnpm monorepo、Electron、React Native/Expo、Git LFS、子模块、跨平台构建以及 AI Agent/模型服务配置。若要深度定制 Agent 编排、MCP 或插件能力，难度会进一步提高。
商业价值
该项目的商业价值主要体现在 AI Agent 客户端入口和真实工作自动化能力上。对个人开发者，它可以整合 Claude Code、Codex、自带 API Key 和本地模型，降低多工具切换成本；对企业团队，它提供了将 AI Agent 接入内部系统、MCP、自动化流程和团队知识技能的基础。Apache-2.0 协议降低了二次开发和商业化风险，适合用于构建私有 AI 助手、研发提效工具、办公自动化客户端或垂直行业 Agent 产品。不过，由于后端服务未开源且部分能力依赖官方云服务或第三方模型，企业落地前需要评估可控性、合规性、部署边界和供应商依赖。
01
技术亮点
- Apache-2.0 开源协议，适合审计、Fork、二次开发和商业集成。
- 支持桌面端 Electron 和移动端 Expo/React Native，具备跨平台产品形态。
- 采用 pnpm monorepo，包含 apps/desktop、apps/mobile 和 packages/*，便于共享认证、设备连接、Agent 编排、模型提供方等能力。
- 支持 Claude Code 和 Codex，未来计划增加更多 harness，并开发原生 harness。
- 支持多模型、多 harness 混合使用，并可在任务中途切换，同时保持工作区、记忆、技能和工具连续。
- 强调本地运行，能够使用用户自己的文件和已登录应用，适合真实工作场景。
- 支持官方云服务和 Local mode，用户可根据隐私、成本和能力需求选择。
- 具备记忆、技能、自动化、MCP、插件市场等长期扩展方向。
- README 明确说明隐私与遥测边界，官方构建不采集聊天内容、文件内容或工作目录数据。
- 对中国大陆和全球账号提供不同开发入口，方便国内开发者接入。
02
目标用户
- 希望在本地电脑上使用 AI Agent 自动完成任务的个人用户
- 使用 Claude Code、Codex 等 AI 编程工具的开发者
- 希望把 AI Agent 接入内部工具、业务系统或 MCP 的企业技术团队
- 需要跨桌面端和移动端构建 AI 助手产品的前端/客户端开发者
- 关注开源 AI Agent 客户端架构的研究者和创业团队
- 希望审计、定制或二次开发 AI Agent 客户端的开发者
03
配置要求
- 需要 Node.js 22.x。
- 需要 pnpm 10.x，暂不支持 pnpm 11。
- 需要 Git LFS。
- 需要初始化 cindy-protocol Git 子模块。
- 默认会连接 Cindy 官方云服务，端点配置位于 config/endpoint.json 和 config/endpoint.global.json。
- 远程开发需要使用自己的 Cindy 云账号，并按区域选择 cn 或 global。
- Local mode 不需要 Cindy 登录，但不连接本地服务器，且不具备服务端能力。
- 桌面端打包过程中会按平台下载 claude-code、codex、ripgrep 等工具二进制文件。
- Windows 打包前会下载并校验 Android platform-tools。
- 官方发行版包含 TapDB 使用统计；源码构建时移动端默认无 TapDB 凭据则不启用，桌面端可通过移除 initTapdb() 禁用。
- 如需使用 Claude Code / Codex Coding Plan、自带 API Key 或本地模型，需要根据对应模型和服务完成授权或配置。
04
适用场景
- 在本地项目目录中让 AI Agent 读取文件、修改代码、执行开发任务
- 通过 Claude Code 或 Codex 完成代码生成、重构、调试和评审
- 在同一任务中切换不同模型或 harness，并保持工作区、记忆、技能和工具上下文连续
- 使用桌面客户端驱动浏览器、电脑应用或已登录的本地应用完成实际操作
- 通过移动端与桌面端联动，让 AI Agent 接收即时消息或日程任务
- 构建定时自动化任务，例如周期性报告、例行检查、项目维护
- 将企业内部工具通过 MCP 接入 Agent 工作流
- 基于 Apache-2.0 源码进行私有化定制、UI 改造或插件扩展
05
部署与配置
- 安装 Node.js 22.x。
- 安装 pnpm 10.x，注意 README 明确说明 pnpm v11 暂不支持。
- 安装 Git LFS。
- 克隆仓库：git clone https://github.com/makecindy/cindy.git
- 进入项目目录：cd cindy
- 初始化协议子模块：git submodule update --init --recursive cindy-protocol
- 拉取 Git LFS 文件：git lfs pull
- 安装依赖：pnpm install
- 中国大陆账号开发运行：pnpm restart:desktop:remote --region=cn
- 全球账号开发运行：pnpm restart:desktop:remote --region=global
- 如无需登录 Cindy 云服务，可在登录界面选择 Local mode，但该模式无法使用服务端能力。
06
风险与注意事项
- 后端服务不在本仓库中，完整云端能力无法仅通过该仓库自托管复现。
- 默认连接 Cindy 官方云服务，企业内网或强合规场景需要重点评估数据流和服务依赖。
- Local mode 能力有限，无法使用服务端支持的功能。
- 项目涉及本地文件、已登录应用、浏览器和设备控制，若权限管理不当可能带来安全风险。
- AI Agent 自动执行真实操作，可能出现误删文件、错误提交代码、误操作业务系统等风险。
- Claude Code、Codex、模型 API、本地模型等依赖外部工具或服务，稳定性和成本受第三方影响。
- 官方发行版包含 TapDB 使用统计，虽然说明不采集聊天和文件内容，但企业使用仍需审计。
- 依赖 Node 22、pnpm 10、Git LFS、子模块和平台二进制下载，国内网络环境下安装可能遇到下载失败或速度问题。
- 插件市场、团队技能共享、原生 harness 等能力仍处于规划或建设中，不能按成熟功能预期使用。
- 仓库 Stars 约 382，生态仍在早期阶段，社区规模和长期维护能力需要持续观察。
2026-07-29
第6名
新收录 · github_search
2026-07-28
第6名
新收录 · github_search
2026-07-27
第21名
新收录 · github_search
