makecindy/cindy

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

그것이 무엇인가

Cindy는 자신의 컴퓨터에서 실행되고 프로젝트와 앱에서 실제 작업을 수행하는 오픈소스 AI 에이전트입니다. "즉시 사용 가능"하도록 설계되었습니다 — 첫날부터 준비되어 있지만, 시간이 지남에 따라 사용자 지정할 수 있습니다.

핵심 개념

Cindy는 여러 하네스(기본 에이전트 엔진), 모델, 도구를 단일 에이전트로 결합합니다. 처음 지원되는 하네스는 Claude Code와 Codex이며, 더 많은 것이 계획되어 있고 네이티브 하네스가 개발 중입니다. 모델과 하네스는 자유롭게 혼합할 수 있으며, 작업 공간, 메모리, 스킬, 도구가 연속적으로 유지되는 동안 작업 중간에 전환할 수 있습니다. 단일 작업도 다른 하네스 × 모델 조합에서 실행되는 에이전트에 의해 계획, 병렬 실행, 검토될 수 있습니다. Cindy는 브라우저, 컴퓨터, 전화도 제어할 수 있으며, 인스턴트 메시지와 일정에서 작업을 가져올 수 있습니다.

이 저장소의 내용

이 저장소는 Cindy의 오픈소스 클라이언트 — 데스크톱 및 모바일 앱과 공유 패키지로, pnpm 모노레포로 구성되어 있습니다:

경로	설명
`apps/desktop`	Electron 데스크톱 클라이언트
`apps/mobile`	Expo / React Native 모바일 클라이언트
`packages/*`	공유 클라이언트 기능(인증, 장치 링크, 에이전트 오케스트레이션, 모델 공급자 등)
`apps/*-bin`	데스크톱 앱과 함께 제공되는 도구 바이너리(플랫폼별로 다운로드되며 커밋되지 않음)

백엔드 서비스는 별도의 저장소에 있으며 이 모노레포의 일부가 아닙니다.

모델 및 계정

모델을 여러 옵션으로 가져올 수 있습니다:

공식 Cindy 서비스에 로그인 — 사용량이 투명하게 차감됩니다
이미 지불한 Claude Code / Codex 코딩 플랜을 승인하고 Cindy 내에서 계속 사용 — 이중 청구 없음
자체 API 키 연결
로컬 모델 사용

두 가지 사용 모드가 있습니다:

모드	계정 요구 사항	가용성
호스팅 서비스	Cindy 클라우드 계정	전체 호스팅 서비스, 가격은 cindy.app 참조
로그인 건너뛰기	Cindy 로그인 불필요	로컬 에이전트만; 서버 지원 기능 사용 불가

사용자 지정("당신의 형태로")

메모리 — 한 번 수정하면 그 후로는 올바르게 수행하며, 하네스 간에 공유됩니다
스킬 — 작업 방식을 한 번 가르치면 어디서나 재사용할 수 있습니다. 팀 공유는 준비 중입니다
자동화 — 반복 작업이 스스로 일정을 잡고, 실행하고, 보고합니다
MCP — 내부 도구와 비즈니스 시스템을 그녀의 범위에 연결합니다
플러그인 — 기능, UI, 상호 작용을 재구성하고, 오픈 마켓플레이스를 통해 공유 * (준비 중) *
소스 — 감사, 포크, 확장, Apache-2.0 하에서 개선 사항 기여

개인정보 및 원격 측정

공식 배포 빌드에는 집계 통계(장치 식별자, OS/앱 버전, 시작 및 활동 이벤트)를 위한 TapDB 사용 분석이 포함됩니다. 로그인 후 이벤트는 계정 ID와 연결되므로 완전히 익명이 아닙니다. TapDB는 채팅 콘텐츠, 파일 콘텐츠 또는 작업 디렉터리 데이터를 수집하지 않습니다.

코드를 편집하지 않고 사용 분석을 비활성화할 수 있습니다: 데스크톱 → 설정 → 정보 → 사용 통계; 모바일 → 설정의 사용 통계. 기본값은 켜짐입니다.

기타 사항:

데스크톱은 비활성화하면 즉시 보고를 중지합니다. 로컬 모드(로그인 건너뛰기)는 TapDB에 전혀 보고하지 않습니다
모바일은 비활성화하면 즉시 계정 연결을 해제하고 명시적 보고를 중지합니다
온라인 하트비트 및 진단 로그는 별도 메커니즘이며, 사용 통계 스위치의 영향을 받지 않습니다
데스크톱 네이티브 크래시 덤프는 로컬에 유지되며 자동으로 업로드되지 않습니다
소스에서 빌드: 데스크톱 개발 빌드는 기본적으로 TapDB를 초기화하지 않습니다. 모바일은 주입된 TapDB 구성 없이는 초기화하지 않습니다

시작하기(개발)

사전 요구 사항: Node.js 22.x, pnpm 10.x(v11은 아직 지원되지 않음), Git LFS

최소 진입점:

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

개발 진입점:

pnpm restart:desktop:remote --region=cn      # 중국 본토 Cindy 계정
pnpm restart:desktop:remote --region=global  # 글로벌 Cindy 계정

원격 개발은 자신의 Cindy 클라우드 계정과 기존 로그인 상태를 사용합니다. 클라이언트는 기본적으로 Cindy의 공식 클라우드 서비스에 연결됩니다 — 외부 개발자는 서버를 자체 호스팅할 필요가 없습니다.

기여 및 라이선스

기여는 main으로의 풀 리퀘스트를 통해 이루어집니다
모든 커밋에는 Developer Certificate of Origin 서명이 필요합니다(git commit -s). DCO 검사가 이를 강제하며, CLA는 필요 없습니다
코드는 Apache-2.0 라이선스입니다(저장소 루트의 LICENSE가 적용됩니다. 개별 파일에는 헤더가 없습니다)
모델 가중치, 데이터 세트, 프롬프트, 상표 및 기타 별도로 식별된 자료에는 자체 라이선스 조건이 있을 수 있습니다
보안 문제는 SECURITY.en.md에 따라 비공개로 보고하세요 — 공개 이슈를 열지 마세요

추가 정보

웹사이트: cindy.app · 다운로드: cindy.app/download
Linux 사용자: docs/linux.md의 Ubuntu, Arch Linux, Omarchy 설치 가이드를 참조하세요
아키텍처 문서: DESIGN.md, docs/README.md, docs/auth-realm-routing.md, AGENTS.md, docs/dev-rules/