makecindy/cindy

Getting started

Contributor setup, Git LFS, dependency updates, and access requirements are maintained in CONTRIBUTING.en.md. Plugins are installed through SkillHub or manually.

git clone https://github.com/makecindy/cindy.git
cd cindy
git lfs pull
pnpm install

Prerequisites

• Node.js 22.x
• pnpm 10.x (v11 is not yet supported)

Architecture

• DESIGN.md — visual design system, color tokens, and UI conventions
• docs/README.md — complete documentation and rules index
• docs/auth-realm-routing.md — organization SSO region discovery and session endpoint routing
• CONTRIBUTING.en.md — contributor setup, validation, and submission workflow
• AGENTS.md — engineering rules, launch/runtime contracts, and module boundaries
• docs/dev-rules/ — deep-dive architecture docs (e.g. Orca multi-agent orchestration)

Yours to shape

Ready out of the box, never boxed in — start with CONTRIBUTING.en.md and build Cindy with us.

• Memory — correct her once and she does it right from then on, shared across harnesses.
• Skills — teach a way of working once and reuse it everywhere; handing them to your team is in the making.
• Automation — recurring work schedules itself, runs itself, reports back.
• MCP — wire your internal tools and business systems into her reach.
• Plugins — reshape features, UI and interactions, shared through an open marketplace (in the making).
• Source — audit, fork, extend, and contribute improvements back under Apache-2.0.

概述

Cindy is an open-source AI agent that works out of the box. She brings multiple harnesses, models and tools into one agent that finishes real work in your projects and apps. Ready from day one, yours to shape over time.

Cindy runs locally on your own machine, using your real files and logged-in apps. The first supported harnesses are Claude Code and Codex — more are being added, and a native harness is in the works. Models and harnesses mix freely and can switch mid-task while your workspace, memory, skills and tools stay continuous; one task can even be planned, executed in parallel, and reviewed by agents on different harness × model combos. She can drive your browser, computer and phone, and take work from IM and schedules.

This repository is the open-source client for Cindy — the desktop and mobile apps plus their shared packages, organized as a pnpm monorepo.

The client is free to use, and its source code is open under Apache-2.0. Bring models your way: sign in to the official Cindy service (usage deducted transparently), authorize the Claude Code / Codex Coding Plan you already pay for and keep using it inside Cindy — no duplicate bill — connect your own API keys, or use local models. See cindy.app for service details, pricing, and downloads.

Development entry points

Remote development uses your own Cindy cloud account and existing login state, so you can continue existing sessions and work while developing the client. Use cn for Mainland China accounts and global for everyone else; do not rely on the internal default. Full desktop, mobile, data-isolation, and validation workflows are in CONTRIBUTING.en.md.

“Skip Sign-In” on the login screen runs local agents without a Cindy account (shown in the app as “Not signed in”), not a connection to a local server. Server-backed capabilities are unavailable in this state.

About the default servers: the client connects to Cindy's official cloud services by default (endpoint manifests in config/endpoint.json and config/endpoint.global.json; desktop auto-updates also come from the official CDN). This is intentional — external developers don't need to self-host a server: sign in with your own Cindy account in a dev build and develop / test directly against the official servers.

Skill Hub migration uses two separate manifest fields: released clients keep using skillhubApiBaseUrl (the deprecated XD proxy), while current clients use cindySkillHubApiBaseUrl. The current client deliberately does not fall back to the legacy field when the new endpoint is absent.