Sobre o projeto
Cindy é uma IA open-source que pretende funcionar imediatamente, reunindo múltiplos harnesses, modelos e ferramentas num único agente que conclui trabalho dentro dos seus projetos e aplicações. É executada localmente na sua própria máquina, usando os seus ficheiros reais e aplicações com sessão iniciada.
Os primeiros harnesses suportados são Claude Code e Codex, com mais a serem adicionados e um harness nativo em desenvolvimento. Modelos e harnesses podem ser combinados e alternados a meio de uma tarefa, enquanto o workspace, a memória, as skills e as ferramentas se mantêm contínuos. Uma única tarefa pode ser planeada, executada em paralelo e revista por agentes em diferentes combinações de harness e modelo. Cindy pode controlar o seu navegador, computador e telefone, e receber trabalho de IM e agendamentos.
Este repositório é o cliente open-source: as aplicações desktop e mobile, mais os seus pacotes partilhados, organizados como um monorepo pnpm. O serviço de backend vive num repositório separado e não faz parte deste monorepo.
Estrutura do repositório:
- apps/desktop — cliente desktop Electron
- apps/mobile — cliente mobile Expo / React Native
- packages/* — capacidades partilhadas do cliente, como autenticação, device-link, orquestração de agentes e fornecedores de modelos
- apps/*-bin — binários de ferramentas incluídos na aplicação desktop; claude-code, codex e ripgrep são descarregados por plataforma pelo pnpm install, e os binários Android platform-tools são obtidos com uma versão fixada e verificação sha256 antes do empacotamento para Windows
Os pontos de personalização e extensão descritos no README incluem memória (as correções persistem entre harnesses), skills (formas reutilizáveis de trabalhar), automação (trabalho agendado recorrente que reporta de volta), MCP (ligação de ferramentas internas e sistemas de negócio), plugins (reformulação de funcionalidades, UI e interações, com um marketplace aberto indicado como em preparação) e acesso ao código-fonte para auditoria, fork e contribuição sob Apache-2.0.
Modos de utilização: um serviço alojado que exige uma conta Cindy cloud, ou uma opção Skip Sign-In que executa agentes locais sem uma conta Cindy (apresentada como Not signed in), na qual as capacidades suportadas pelo servidor não estão disponíveis. Os modelos podem ser trazidos através do serviço oficial Cindy, de uma autorização existente de Claude Code ou Codex Coding Plan, das suas próprias chaves de API, ou de modelos locais.
Os pré-requisitos são Node.js 22.x, pnpm 10.x (v11 ainda não suportado) e Git LFS. A configuração mínima é git, git lfs pull e depois pnpm install. Os pontos de entrada de desenvolvimento incluem pnpm restart:desktop:remote com --region=cn para contas da China Continental e --region=global para as restantes; o desenvolvimento remoto usa a sua própria conta Cindy cloud e o estado de sessão existente. Por predefinição, o cliente liga-se aos serviços cloud oficiais da Cindy através de manifestos de endpoint em config/endpoint.json e config/endpoint.global, e as atualizações automáticas do desktop vêm do CDN oficial.
As referências de documentação incluem DESIGN.md para o sistema de design visual e convenções de UI, docs/README.md como índice da documentação, docs/auth-realm.md para descoberta de região SSO e encaminhamento de sessão, CONTRIBUTING.en.md para configuração e validação de contribuidores, AGENTS.md para regras de engenharia e fronteiras de módulos, e docs/dev-rules/ para documentação de arquitetura mais profunda, como a orquestração multiagente Orca. Um guia para Linux aborda Ubuntu, Arch Linux e Omarchy.
As contribuições são feitas através de pull requests para main, exigem uma assinatura do Developer Certificate of Origin (git commit -s) imposta por uma verificação DCO, e não é necessário CLA. As questões de segurança são reportadas em privado segundo SECURITY.en.md.
Notas de privacidade: as builds de distribuição oficiais incluem análise de utilização TapDB para estatísticas agregadas (metadados de dispositivo, SO e versão da aplicação, associados ao ID de conta após início de sessão) e não recolhem conteúdo de chat, conteúdo de ficheiros ou dados do diretório de trabalho; um heartbeat online com sessão iniciada envia apenas ID de conta, plataforma e versão; os crash dumps ficam locais. As builds a partir do código-fonte podem omitir a análise, uma vez que no mobile é uma no-op sem credenciais TapDB e a análise no desktop pode ser removida eliminando a chamada initTapdb().
Licenciamento: o código-fonte está sob Apache-2.0, salvo indicação em contrário, com pesos de modelos, datasets, prompts e marcas registadas potencialmente sob termos separados; a atribuição de terceiros e as SBOMs SPDX são geridas em docs/legal/.
Comments
0 people shared their preference · Deer Point appears after 10 participants
Sign in to join the discussion.