Is cindy still maintained?

Yes, active. Last change today. Latest release v0.1.128, yesterday.

Some track record. 9.4k stars, 4 months old, by an organization. Get it from the official repo and read what it installs.

gitmanual

Reading the repo

Opening the box…

How to install cindy on macOS (makecindy/cindy) · gitmanual

How to install on macOS

makecindy/cindy

Consider it done. The open-source AI agent that works out of the box · 想到，就能做到。开源、开箱即用的 AI Agent。

Node.js#agent#ai-agent#ai-assistant#android

Difficulty: Moderate
Time: about 15 min
Stars: ★ 9,444
Activity: Updated this month
License: Apache-2.0
Open issues: 2,788
Got it running: Be the first
Looked up: 12 min ago

Saved setup from 12 min ago

Before you start

Is it free?: YesOpen source (Apache-2.0).
Still maintained?: Yes, activeLast change today. Latest release v0.1.128, yesterday.
Can I trust it?: Some track record9.4k stars, 4 months old, by an organization. Get it from the official repo and read what it installs.

Start here

Website ↗cindy.appThe project's own site.

Will it work on my device?

Yes, it installs on your macOS

A ready-made macOS download is in the latest release.

Checking for

macOS Windows Linux

Download for macOS

v0.1.128 · 11/6/2026 ↗

cindy-0.1.128-darwin-arm64-global.dmg

dmg · Apple Silicon · 270.3 MB · 35 downloads · best match

Download

Drag the app into Applications.

curl -LO "https://github.com/makecindy/cindy/releases/download/v0.1.128/cindy-0.1.128-darwin-arm64-global.dmg"
open "cindy-0.1.128-darwin-arm64-global.dmg"

Other macOS downloads (3)

cindy-0.1.128-darwin-arm64-cn.dmg

dmg · Apple Silicon · 270.3 MB · 16 downloads

Download

Drag the app into Applications.

curl -LO "https://github.com/makecindy/cindy/releases/download/v0.1.128/cindy-0.1.128-darwin-arm64-cn.dmg"
open "cindy-0.1.128-darwin-arm64-cn.dmg"

cindy-0.1.128-darwin-x64-cn.dmg

dmg · Intel · 283.9 MB · 5 downloads

Download

Drag the app into Applications.

curl -LO "https://github.com/makecindy/cindy/releases/download/v0.1.128/cindy-0.1.128-darwin-x64-cn.dmg"
open "cindy-0.1.128-darwin-x64-cn.dmg"

cindy-0.1.128-darwin-x64-global.dmg

dmg · Intel · 283.9 MB · 6 downloads

Download

Drag the app into Applications.

curl -LO "https://github.com/makecindy/cindy/releases/download/v0.1.128/cindy-0.1.128-darwin-x64-global.dmg"
open "cindy-0.1.128-darwin-x64-global.dmg"

Did you get it running?

No reports for macOS yet.

Still stuck? Ask an AI

Opens a chat with this manual already filled in, for macOS. It uses your own account; gitmanual sends nothing.

Ask Claude Ask ChatGPT

Parts list

1×Node.js 22.22.3runtime
1×pnpm pnpm@10.33.2package manager

22× settings in .env

VITE_CINDY_AUTH_REGION
XDT_FILO_GOOGLE_CLIENT_ID
XDT_FILO_GOOGLE_CLIENT_SECRETsecret
XDT_VOICE_INPUT_ASR_PROVIDER
XDT_VOICE_INPUT_REFINER_PROVIDER
XDT_VOICE_INPUT_REFINER_MODEL
EXPO_PUBLIC_CINDY_AUTH_REGION
EXPO_PUBLIC_CINDY_DIAGNOSTICSoptional
EXPO_PUBLIC_ENDPOINT_MANIFEST_BASE_URLoptional
EXPO_PUBLIC_ENDPOINT_MANIFEST_PEER_BASE_URLoptional
EXPO_PUBLIC_CINDY_AUTH_BASE_URLoptional
EXPO_PUBLIC_XDT_DEVICE_LINK_API_BASE_URLoptional
EXPO_PUBLIC_CINDY_GOOGLE_WEB_CLIENT_IDoptional
EXPO_PUBLIC_CINDY_GOOGLE_IOS_CLIENT_IDoptional
EXPO_PUBLIC_CINDY_GOOGLE_IOS_URL_SCHEMEoptional
EXPO_PUBLIC_CINDY_WECHAT_APP_IDoptional
EXPO_PUBLIC_CINDY_WECHAT_UNIVERSAL_LINKoptional
EXPO_PUBLIC_TAPTAP_CLIENT_IDoptional
EXPO_PUBLIC_TAPTAP_CLIENT_TOKENsecretoptional
EXPO_PUBLIC_TAPDB_CHANNELoptional
EXPO_PUBLIC_TAPDB_REGIONoptional
EXPO_PUBLIC_XDT_MOBILE_VOICE_LITELLM_BASE_URLoptional

Share this manual

Is this your repo?

Add a badge to your README so newcomers find these steps.

[![Setup manual](https://gitmanual.com/makecindy/cindy/badge.svg)](https://gitmanual.com/makecindy/cindy)

Good to know

Monorepo (workspaces) — install from the repo root.
Has AGENTS.md — instructions for coding agents. You can open Claude Code (or another agent) in the cloned folder and ask it to do the setup for you.
Nested projects: apps/cindy-headless/package.json, apps/desktop/cindy-updater/package.json, apps/desktop/cindy-updater/src-tauri/Cargo.toml, apps/desktop/drizzle/scripts/package.json and 11 more

package.json scripts (81)

hnode scripts/help.mjs
mobile:xcodenode apps/mobile/scripts/open-ios-xcode.mjs
mobile:sim:rebuildnode scripts/ensure-deps.mjs --workspace-only && node apps/mobile/scripts/sim-rebuild.mjs
mobile:sim:upnode scripts/ensure-deps.mjs --workspace-only && node apps/mobile/scripts/sim-up.mjs
mobile:sim:startnode scripts/ensure-deps.mjs --workspace-only && node apps/mobile/scripts/sim-start.mjs
mobile:sim:start:cnnode scripts/ensure-deps.mjs --workspace-only && node apps/mobile/scripts/sim-start.mjs --region=cn
mobile:sim:whoaminode scripts/ensure-deps.mjs --workspace-only && node apps/mobile/scripts/sim-whoami.mjs
mobile:sim:logchecknode scripts/ensure-deps.mjs --workspace-only && node apps/mobile/scripts/sim-logcheck.mjs
mobile:sim:opennode scripts/ensure-deps.mjs --workspace-only && node apps/mobile/scripts/sim-open.mjs
sync:mobile-rich-content-assetsnode apps/mobile/scripts/sync-rich-content-assets.mjs
mobile:release:checknode apps/mobile/scripts/release-with-env.mjs check
mobile:release:prodnode apps/mobile/scripts/release-with-env.mjs prod
mobile:build:iosnode apps/mobile/scripts/build-ios.mjs
mobile:build:androidnode apps/mobile/scripts/build-android.mjs
ensure-depsnode scripts/ensure-deps.mjs
sync:browser-runtimenode scripts/browser-runtime/sync.mjs
repo:worktreesnode scripts/repo-worktrees.mjs
update:claudenode tools/claude/update.mjs
update:codexnode tools/codex/update.mjs
update:codex-packagenode tools/codex-package/update.mjs
update:ripgrepnode tools/ripgrep/update.mjs
update:pinode tools/pi/update.mjs
sync:pi-model-catalognode tools/pi/sync-model-catalog.mjs
update:vendorsnode tools/claude/update.mjs && node tools/codex/update.mjs && node tools/ripgrep/update.mjs && node tools/pi/update.mjs
install:claudenode scripts/ensure-agent-binaries.mjs --kinds=claude

Files we read (12)

.github/workflows/ci.yml

.github/workflows/pr-code-review.yml

.github/workflows/pr-design-basis.yml

.github/workflows/pr-template-rules.yml

.github/workflows/star-history.yml

.nvmrc

CONTRIBUTING.md

README.md

apps/desktop/.env.example

apps/mobile/.env.example

package.json

pnpm-workspace.yaml

Branch main · 18,792 files in the repo