Cindy is an open-source TypeScript-based client monorepo for desktop and mobile AI agents, aiming to run locally with support for Claude Code and Codex harnesses. It provides pnpm-based setup, LFS, and submodules; latest release is v0.1.20 on 2026-07-28. It is licensed under Apache-2.0 and targets Node.js 22.x.
What it is
Cindy is an open-source AI agent client that runs on the user's machine and integrates multiple harnesses and tools into one agent. It is structured as a pnpm monorepo containing desktop and mobile apps plus shared packages.
How it works
The repository combines desktop (Electron) and mobile (Expo/React Native) clients with shared packages for authentication, device linking, agent orchestration, and model providers. It supports running locally or via Cindy cloud accounts, with configurations for local mode and hosted service. The client connects to Cindy official cloud services by default and can be built against local or hosted configurations.
Getting started
Minimal entry point:
git clone https://github.com/makecindy/cindy.git
cd cindy
git submodule update --init --recursive cindy-protocol
git lfs pull
pnpm install
Development entry points include:
# Mainland China Cindy account
pnpm restart:desktop:remote --region=cn
# Global Cindy account
pnpm restart:desktop:remote --region=global
Prerequisites listed: Node.js 22.x, pnpm 10.x, Git LFS.
Recent releases
- v0.1.20 (2026-07-28): Desktop release 0.1.20
- v0.1.18 (2026-07-27): Desktop release 0.1.18
- v0.1.17 (2026-07-27): Desktop release 0.1.17
Traction
- stars_1d: 153
- stars: 988
- forks: 123
- open_issues: 255
Behind the repo
Not included in this repo description.
Caveats
- License: Apache-2.0
- Requires Git LFS, Node.js 22.x, pnpm 10.x
- The README notes that the backend service lives in a separate repository and is not part of this monorepo.