내 컴퓨터와 앱에서 실제 업무를 끝까지 처리하는 AI 에이전트를 직접 꾸며 쓰는 방법
브라우저를 열고, 파일을 수정하고, 일정에서 일을 가져와서 처리하는 AI를 내 데스크톱과 모바일에서 바로 실행해 봅니다. Cindy는 여러 AI 모델과 도구를 하나로 묶어 실제 프로젝트의 일을 완수하는 오픈소스 클라이언트입니다. 설치만 하면 바로 사용 가능하며, 내 취향에 맞게 기억력과 기능을 확장할 수 있습니다.
내 환경에서 일하는 방식
Cindy는 내 컴퓨터에 설치되어 실제 파일과 로그인된 앱을 직접 다룹니다. 처음 지원되는 하네스(에이전트를 실행하는 프레임워크)는 Claude Code와 Codex이며, 더 많은 하네스가 추가되고 있습니다. 하나의 작업 중에도 모델과 하네스를 자유롭게 전환할 수 있으며, 이때 작업 공간과 기억력은 유지됩니다. 하나의 작업을 여러 에이전트가 다른 조합으로 계획하고, 병렬로 실행하고, 검토하는 것도 가능합니다. 브라우저, 컴퓨터, 스마트폰을 조작하고 IM이나 일정에서 일을 가져와 처리합니다.
내 손으로 바꾸는 부분
오픈소스인 만큼 코드를 볼 수 있을 뿐만 아니라 직접 수정할 수 있습니다.
- 기억력 한 번의 교정으로 영구적인 학습이 이루어지며, 하네스 간에 공유됩니다.
- 스킬 일하는 방식을 정의해 어디에서든 재사용하며, 팀 공유 기능은 개발 중입니다.
- 자동화 반복 업무를 자동으로 일정화하고 실행하며 결과를 보고합니다.
- MCP 내부 도구와 비즈니스 시스템을 에이전트의 접근 범위에 연결합니다.
모델과 계정 선택
클라이언트는 무료로 사용 가능하며, 소스 코드는 Apache-2.0 라이선스 하에 공개됩니다. 모델을 원하는 방식으로 가져올 수 있습니다. 공식 Cindy 서비스에 로그인하면 사용량이 투명하게 차감되며, 이미 결제 중인 Claude Code나 Codex 플랜을 인증해 중복 과금 없이 사용할 수 있습니다. 자신의 API 키를 연결하거나 로컬 모델을 사용하는 것도 가능합니다. 로그인 없이 'Skip Sign-In'을 선택하면 로컬 에이전트만 사용할 수 있으며, 서버 기반 기능은 비활성화됩니다.
개발 환경과 구조
이 저장소는 pnpm 모노레포로 구성된 데스크톱과 모바일 앱, 그리고 공유 패키지로 이루어져 있습니다. 데스크톱은 Electron, 모바일은 Expo와 React Native로 개발되었습니다. Node.js 22.x, pnpm 10.x, Git LFS가 필요합니다. Linux 사용자는 Ubuntu, Arch Linux, Omarchy 설치 가이드를 참고해야 합니다. 백엔드 서비스는 별도의 저장소에 있으며 이 모노레포에 포함되지 않습니다. 원격 개발은 자신의 Cindy 클라우드 계정과 기존 로그인 상태를 사용하므로 개발 중에도 기존 세션을 계속할 수 있습니다.
사용 전 확인 사항
Cindy는 내 컴퓨터의 실제 파일과 앱에 접근하므로, 민감한 데이터를 다루는 환경에서는 주의가 필요합니다. 공식 배포 빌드에는 TapDB 사용 분석이 포함되어 있으며, 이는 계정 ID와 연결된 장치 및 OS 메타데이터만 수집합니다. 채팅 내용, 파일 내용, 작업 디렉터리 데이터는 수집하지 않습니다. 소스에서 빌드할 경우 분석 기능을 비활성화할 수 있습니다. 모델 가중치, 데이터셋, 프롬프트 등은 별도의 라이선스 조건이 적용될 수 있으며, 저장소 루트의 Apache-2.0 라이선스로 자동 커버되지 않습니다. 보안 문제는 공개 이슈가 아닌 SECURITY.en.md에 따라 비공개로 보고해야 합니다.
