# makecindy/cindy

> Cindy is an open-source AI agent meant to finish real work in your projects and apps. It runs on your own machine using your local files and logged-in apps, and it brings multiple harnesses, models and tools into one agent. This repository holds the open-source client, which includes a desktop app, a mobile app and shared packages, written mainly in TypeScript.

Source: https://github.com/makecindy/cindy
Indexed: commit 82d44ec on 2026-10-27 by Repowise. Facts come from the source and git history, not from the maintainer.

## Facts

- Type: MCP server
- Language: TypeScript
- Stars: 10,258 at index time
- License: Apache-2.0
- Code health: 6.5/10, Fair
- Last commit: 2026-10-27
- Contributors: 173

## Install

From the README: https://github.com/makecindy/cindy#getting-started

Clone the cindy repository.
    git clone https://github.com/makecindy/cindy.git

Move into the cindy folder.
    cd cindy

Pull the Git LFS files in the repository.
    git lfs pull

Install the dependencies with pnpm.
    pnpm install

Start the desktop app for a Mainland China Cindy account.
    pnpm restart:desktop:remote --region=cn

## How it works

Input reaches the client as user prompts, IM channel messages, and account and device state, and the desktop app, mobile app and headless CLI are the surfaces people use. apps/desktop is the Electron client that runs on a user's own machine, handling clicks, local files and messages from cloud and device peers. apps/mobile is a React Native client for phones that reshapes session and remote-device data for its screens. packages/lizi-im gives the desktop app one way to talk to chat platforms such as Feishu, Telegram and Discord, sending replies and files back out. packages/lizi-mcps builds the in-process MCP servers that give desktop agents their tools, each with its own tool list. apps/cindy-headless/src/cli.ts is the entry point for the headless command line interface.

- apps/cindy-headless/src/cli.ts: entry point
- apps/cindy-headless/src/eval-cli.ts: entry point
- apps/desktop/cindy-updater/src-tauri/src/lib.rs: entry point
- apps/desktop/cindy-updater/src-tauri/src/main.rs: entry point
- apps/desktop/cindy-updater/ui/app.js: entry point
Modules: apps, packages, scripts, tools, docs. 15,969 files, 3,431,342 lines, 115,624 symbols.

## Code health

- Score: 6.5/10 (Fair)
- Rank: #185 of 4,000+ indexed repos
- Hotspots: apps/desktop/src/main/maker-ipc/register.ts, packages/maker-core/src/agents/codex/index.ts, apps/mobile/app/sessions/[sessionId].tsx, apps/desktop/src/main/cindy-brain/index.ts, apps/desktop/src/renderer/lib/makerChatStore.ts
- Lowest file: packages/maker-core/src/agents/pi/index.ts
- Dead code: 675 findings

## Maintenance

- Last commit 2026-10-27, first commit 2026-07-24, 8,305 commits
- 173 contributors, bus factor 2

## Security

- Security findings are shown to signed-in users at https://repowise.dev/repo/makecindy/cindy/security

## More

- Page: https://repowise.dev/repo/makecindy/cindy
- Ask this codebase: https://repowise.dev/repo/makecindy/cindy/chat
- Docs: https://repowise.dev/repo/makecindy/cindy/docs
- MCP (signs in with Repowise on first use):
    claude mcp add --transport http repowise https://api.repowise.dev/mcp/makecindy/cindy
