Cindy is an open-source AI agent, ready out of the box and yours to shape.
Connect your computers and phone, bring the models and subscriptions you already
use, and build a companion that knows how you like to work.
All your devices. One Cindy.
Your work computer, home desktop, laptop and phone belong together.
- Pick up the same work. Open a session from another device, continue the
conversation, and access its files without copying everything into a new chat.
- Share more than a screen. Use model providers configured on another
computer — including supported subscriptions, API providers and local models.
- Reach your whole desktop. Built-in remote desktop on your phone lets you
open apps, type and operate a connected computer when a chat isn't enough.
Your computer becomes your server: no server rental or self-hosting setup.
For remote access to your computers, keep them online, sign in with the same
account and enable the relevant permissions. Model sharing requires allowing
remote access to that provider; remote desktop also needs its own permissions.
Project files stay on their computer — remote access is not whole-disk sync.
Cloud companions sync their conversations, memory, skills and shared attachments
through Cindy's services; model providers process the requests sent to them.
Provider and service billing still apply.
Keep your favorite agents. Get a better way to work.
Already using Claude Code or Codex? Cindy brings them together with Pi,
then adds a shared interface, multi-device access, tools and a companion of
your own.
| Harness | What it brings |
|---|
| Claude Code | Claude Code's agent workflow, with Cindy's interface and connected tools. |
| Codex | Codex's coding workflow, available alongside your other agents. |
| Pi | A lean, open-source, extensible agent with support for multiple model providers. |
Choose a supported harness and model combination, and change it as the work
evolves. Your session stays in Cindy; switching harnesses hands off or rebuilds
the engine context rather than making their internal states identical.
One agent not enough? Let her lead a team. Use different agents for planning,
parallel implementation and independent review, with a shared goal and clear
acceptance criteria.
Real work, in your actual tools
Work with your files, browser and apps. Ask for a change, inspect what happened,
and keep working from the result. Answers can include charts, interactive
controls and rich HTML, not just a wall of text.
Build a recurring routine with automations, or hand over work through
connected chat channels such as Slack and Telegram. Connect more tools through
Skills, plugins and MCP.
Ready from day one. Yours to shape over time.
- Create your own companions. Give them a role, instructions, skills and
recurring work — a reviewer, researcher, project partner, or something of your own.
- Make experience reusable. Keep useful preferences and knowledge in memory;
turn a good way of working into a Skill you can reuse and share.
- Extend the product. Discover Skills and plugins in SkillHub, connect your
own tools, or build on the official plugins.
- Help shape Cindy. Audit the code, fork it, improve an interaction, fix a bug,
or contribute a useful integration. The client is Apache-2.0 licensed.
Open source means more than visible — it means changeable.
Build Cindy with us →
Start with what you already have
The client is free. Authorize a supported subscription you already pay for,
including Claude Code or Codex plans, connect your own API keys, or use a local
model. You can also use Cindy's managed model service. Provider limits and
billing still apply; the free client does not mean unlimited model usage.
macOS · Windows · Linux · iOS · Android
Download Cindy · Service pricing
Linux users: see the Ubuntu, Arch Linux and Omarchy installation guide
for installation, updates, keyring setup and migration from a manual install.
For developers
This repository contains Cindy's open-source desktop and mobile clients and
their shared packages, organized as a pnpm monorepo.
What's in this repo
| Path | Description |
|---|
apps/desktop | Electron desktop client |
apps/mobile | Expo / React Native mobile client |
packages/* | Shared client capabilities (auth, device-link, agent orchestration, model providers, …) |
apps/*-bin | Tool binaries shipped with the desktop app; none are committed — claude-code, codex, and ripgrep are downloaded per platform by pnpm install, and the Android platform-tools binaries are fetched (pinned version, sha256-verified) before Windows packaging |
Not in this repo: the backend service lives in a separate
repository and is not part of this monorepo.
| Mode | Account requirement | Availability |
|---|
| Hosted service | Cindy cloud account | Use Cindy's full hosted service. See pricing. |
| Skip Sign-In | No Cindy sign-in required | Choose “Skip Sign-In” on the login screen to use local agents; the app then shows the account state as “Not signed in”. Server-backed capabilities are unavailable in this state. |
Prerequisites
- Node.js 22.x
- pnpm 10.x (v11 is not yet supported)
- Git LFS
Getting started
Contributor setup, Git LFS, dependency updates, and access requirements are maintained in
CONTRIBUTING.en.md.
Plugins are installed through SkillHub or manually.
Minimal entry point:
git clone https://github.com/makecindy/cindy.git
cd cindy
git lfs pull
pnpm install
Development entry points
# Mainland China Cindy account
pnpm restart:desktop:remote --region=cn
# Global Cindy account
pnpm restart:desktop:remote --region=global
This is the beginning of the README. Read the rest at the original. Read the full README ↗
