Cindy
An open-source desktop and mobile agent for completing work on your computer and signed-in apps.
- Source repo
- makecindy/cindy
- Stars
- ★ 2.8k
- Last updated
- 3d ago
- License
- Apache-2.0
- Primary language
- TypeScript
- FA score
- 52/100 · Major gaps
At a glance
- Works with
- Portable with changesCodex · Claude Code
- You'll need
- Typical use
- A developer with an existing Claude Code or Codex Coding Plan who wants to use that authorization in one client and switch harnesses during a task.
- Main limitation
- This repository is client-only; the backend service is in a separate repository, so it does not document a complete self-hosted server deployment.
- Source review
- 52/100 · Major gaps
What does this agent do, and when should you use it?
Cindy is an open-source AI agent client delivered as an Electron desktop app, an Expo/React Native mobile app, and shared packages in a pnpm monorepo. It runs on the user’s own machine and is described as working with real files and logged-in applications. Its first documented harnesses are Claude Code and Codex, with task-time switching across harnesses and models while workspace, memory, skills, and tools remain continuous. The repository also describes browser, computer, and phone control, plus work intake from IM and schedules; the backend service is explicitly outside this repository. Users can sign in to the official Cindy service or choose Skip Sign-In for local agents, with server-backed capabilities unavailable in that state.
The Cindy client brings Claude Code, Codex, models, and tools into one task environment for work involving local files and signed-in apps. A task can be planned, executed in parallel, and reviewed by agents using different harness × model combinations while its workspace, memory, skills, and tools continue across those stages. apps/desktop contains the desktop client, apps/mobile contains the mobile client, and packages/* holds shared capabilities including auth, device-link, agent orchestration, and model providers. It also documents MCP connections to internal tools and business systems, along with Automation for scheduling recurring work and reporting back.
- A developer with an existing Claude Code or Codex Coding Plan who wants to use that authorization in one client and switch harnesses during a task.
- An individual or team member who needs an agent to work with project files and applications already signed in on their computer.
- An organization connecting internal business systems and tools to task workflows through MCP.
- An operations user scheduling recurring work to run automatically and return a report.
- A user who needs both Cindy’s desktop client and its mobile client.
How do you install or deploy this agent?
Install Node.js 22.x, pnpm 10.x, and Git LFS, then run:
git clone https://github.com/makecindy/cindy.git
cd cindy
git submodule update --init --recursive cindy-protocol
git lfs pull
pnpm installThe repository states that a public checkout needs the cindy-protocol submodule. Remote development against the official service requires your own Cindy cloud account and existing login state.
How do you use this agent?
For a Mainland China Cindy account, run: pnpm restart:desktop:remote --region=cn. For a global account, run: pnpm restart:desktop:remote --region=global. After signing in, you can continue existing sessions; alternatively choose “Skip Sign-In” on the login screen to run local agents. That state is shown as “Not signed in” and does not include server-backed capabilities. The supplied documentation does not provide a public HTTP API, SDK invocation example, or local server startup command.
What are this agent's strengths and limitations?
- It documents Claude Code and Codex as first-class harnesses in one task environment, including switching harnesses and models mid-task.
- Electron desktop and Expo/React Native mobile clients share capabilities such as auth, device-link, agent orchestration, and model providers.
- It supports several documented model-access routes: the official service, existing Claude Code/Codex Coding Plan authorization, user API keys, and local models.
- It explicitly offers a local-agent Skip Sign-In path and MCP connectivity for internal tools and business systems.
- This repository is client-only; the backend service is in a separate repository, so it does not document a complete self-hosted server deployment.
- Skip Sign-In disables server-backed capabilities, reducing the available feature set.
- Building from source requires Node.js 22.x, pnpm 10.x, Git LFS, and the cindy-protocol submodule; pnpm v11 is not yet supported.
- Default endpoints target official Cindy cloud services and the official CDN, while remote development requires a Cindy cloud account and existing login state.
- The open plugin marketplace and team sharing for skills are still described as in the making.
How does this agent compare with similar options?
Compared with using Claude Code or Codex separately, Cindy documents them as harnesses that can switch within one task while preserving the workspace, memory, skills, and tools. Whether it uses the official service, user API keys, or local models depends on the selected setup.
Key facts side by side with the most closely related agents.
| Agent | Source review | Stars | Updated | Language | Full support on |
|---|---|---|---|---|---|
| Cindy This agent | 52 · Major gaps | ★ 2.8k | 3d ago | TypeScript | Codex · Claude Code |
| MyAgents | 57 · Major gaps | ★ 896 | 5d ago | TypeScript | Codex · Claude Code · Claude API |
| Memmy — Personal AI Agent & Local Memory Hub | 42 · Major gaps | ★ 2k | today | TypeScript | Codex · Claude Code · OpenAI API |
| COMPASS Skills | 85 · Good | ★ 735 | 28d ago | Python | Codex · Claude Code |
How does FollowAgents rate this agent?
Why each dimension lost points
Evidence: README explicitly states default connection to official cloud services and discloses telemetry (TapDB) and heartbeat data, but lacks user confirmation mechanisms or data flow visualization. Dependency security: package.json has overrides and patchedDependencies, CI verifies submodule source, but no dependency vulnerability scanning evidence. External effects: README mentions driving browser, computer, and phone, but no permission controls. Rollback: not mentioned. Source attribution: DCO and contribution guidelines present, but publisher unverified. Deductions: lack of user confirmation, least privilege, and rollback implementation evidence.
Evidence: CI configures multi-platform tests (Linux/Windows) and sharding, but no test results or coverage. Dependency availability: pnpm lockfile and overrides present, but no availability guarantees. Failure messages: no specific error handling examples. Deductions: static review cannot verify test execution; failure message evidence insufficient.
Evidence: README describes multiple use cases (desktop, mobile, browser, IM) and capability boundaries (local running, supports Claude Code and Codex). Trigger precision: no specific trigger mechanisms. Environment fit: multi-platform and Node version requirements. Deductions: trigger precision evidence insufficient.
Evidence: README provides clear architecture and documentation index, installation steps, Apache-2.0 license, contribution guidelines. Naming stability: no version history. Examples and FAQ: basic examples but no FAQ. Known limitations: some features in progress. Versioning changelog: absent. Maintenance responsibility: SECURITY.md and contribution guidelines. Deductions: missing changelog and FAQ.
Evidence: README describes output capabilities (completing tasks, reporting), but no specific output examples. Marginal value: emphasizes open-source and customization, but no comparison with other tools. Cost-benefit: mentions free use and bring-your-own models, but no detailed cost analysis. Deductions: output usability evidence insufficient.
Evidence: README claims partially supported by docs (architecture, security), but no independent verification. Cross-source corroboration: no external references. Fact-inference separation: README distinguishes facts and plans, but not explicitly labeled. Deductions: lack of independent verification and external corroboration.
- Default connection to official cloud services may raise data privacy and network dependency concerns.
- Telemetry data, though not containing chat content, is associated with account ID; users should be informed.
- Dependencies are downloaded from third parties; despite SHA256 verification, supply chain security should be ensured.