La plupart des agents IA actuels tournent en rond dans des bacs à sable distants. Ils manquent de contexte réel, ignorent vos fichiers locaux et perdent le fil dès qu’une tâche traverse plusieurs logiciels. J’ai longtemps cherché un outil capable de travailler directement sur mon poste sans tout téléverser sur un serveur tiers.
Le projet open source Cindy change cette donne. Cindy est un agent logiciel pensé pour exécuter des missions concrètes en utilisant vos outils quotidiens, vos sessions ouvertes et vos fichiers en dur. Elle rassemble sous une même interface plusieurs moteurs d’exécution, plusieurs modèles de langage et des ponts d’automatisation vers vos terminaux mobiles ou vos messageries d’équipe.
Le dépôt officiel héberge le client complet sous licence Apache-2.0, articulé sous forme d’un monorepo combinant Electron pour l’application de bureau et Expo pour l’application mobile. Le code source est transparent : vous pouvez l’examiner, l’adapter ou en retirer ce qui vous dérange.
Comment Cindy pilote vos projets : harnais et multi-agents
Le terme central chez Cindy est le « harnais » (harness). Il désigne le moteur d’exécution sous-jacent qui pilote le code et les commandes. Aujourd’hui, Cindy prend en charge Claude Code ainsi que Codex, tout en préparant son propre harnais natif. Contrairement aux agents monolithiques qui vous enferment avec un seul fournisseur, Cindy jongle entre ces moteurs en plein milieu d’une session sans vous faire perdre votre contexte de travail, votre mémoire ou vos compétences enregistrées.
Regardons une répartition typique d’une tâche lourde sur ce système :
- Planification initiale : Claude Code associé à Fable 5 découpe le besoin en plusieurs chantiers indépendants.
- Exécution parallèle : trois sous-agents propulsés par Grok 4.5, Kimi K3 et GLM 5.2 écrivent et corrigent les modules simultanément.
- Revue critique : Codex allié à GPT-5.6 inspecte les modifications générées avant toute fusion définitive.
- Validation finale : vous gardez le contrôle direct sur la fenêtre d’approbation avant écriture sur disque.
Cindy maintient la cohérence globale du projet pendant que les modèles se passent le relais. Elle pilote votre navigateur, interagit avec vos fenêtres système et peut même recevoir des ordres depuis votre téléphone ou un bot de messagerie.
Inspection du monorepo et structure du code
Avant d’installer l’outil, examinons la topologie du dépôt GitHub de Cindy. L’organisation suit une logique monorepo gérée avec pnpm :
| Chemin dans le dépôt | Rôle et contenu technique |
|---|---|
apps/desktop | Client lourd développé sous Electron pour macOS, Windows et Linux. |
apps/mobile | Application mobile conçue avec Expo et React Native. |
packages/* | Bibliothèques partagées : authentification, liaison entre appareils, orchestration multi-agents et adaptateurs de modèles. |
apps/*-bin | Binaires d’outillage téléchargés à l’installation (ripgrep, claude-code, codex, outils Android adb). |
Notez un point d’architecture capital : les serveurs d’arrière-plan ne résident pas dans ce dépôt. Cindy propose un client ouvert qui s’interface soit avec ses services distants officiels, soit directement avec vos clés privées et vos modèles hébergés sur votre propre réseau.
Prérequis et installation pas à pas
Pour construire le client Cindy depuis les sources sans heurts, préparez votre environnement local avec les versions logicielles exactes :
- Node.js en version 22.x.
- pnpm en version 10.x (la version 11 n’est pas supportée pour le moment, évitez-la).
- Git LFS installé sur votre système d’exploitation.
Sur Linux, vérifiez la configuration de votre trousseau de clés système (GNOME Keyring ou KWallet). Les guides pour Ubuntu, Arch Linux et Omarchy détaillent ces points dans la documentation officielle du projet.
Clonez le code source et installez l’ensemble des paquets :
git clone https://github.com/makecindy/cindy.git
cd cindy
git lfs pull
pnpm installDurant l’exécution de pnpm install, les binaires d’exécution précompilés comme ripgrep ou les outils de plateforme Android sont rapatriés automatiquement avec vérification par empreinte sha256. Aucun binaire exécutable lourd n’est stocké directement dans l’historique Git.
Démarrage et modes d’exécution
Cindy s’utilise de deux manières distinctes, selon votre besoin de synchronisation en ligne :
| Mode sélectionné | Compte requis | Fonctionnalités disponibles |
|---|---|---|
| Hosted Service | Compte cloud Cindy | Accès complet à la synchronisation distante, aux déclencheurs programmés et aux relais mobiles. |
| Skip Sign-In | Aucun compte requis | Exécution strictement locale sur votre machine. L’application affiche l’état « Not signed in ». |
En choisissant Skip Sign-In sur l’écran d’accueil, vous bloquez tout contact non désiré avec l’infrastructure cloud Cindy. Vos agents tournent alors exclusivement via vos propres clés d’API (Claude Code, Codex, modèles locaux Ollama ou vLLM).
Si vous développez sur le client en utilisant l’infrastructure cloud officielle, lancez la commande adaptée à votre zone géographique :
# Pour les comptes enregistrés en Chine continentale
pnpm restart:desktop:remote --region=cn
# Pour tous les autres comptes internationaux
pnpm restart:desktop:remote --region=globalCette distinction de région oriente les appels vers les bons terminaux d’API définis dans config/endpoint.json et config/endpoint.global.json. Les mises à jour automatiques du client transitent par ces mêmes réseaux.
Gouvernance, isolation et sécurité du poste
Donner la main à un agent sur son shell local donne des sueurs froides à n’importe quel ingénieur système. Pour éviter les désastres, Cindy intègre des barrières strictes :
1. Espaces de travail isolés : Les scripts et réécritures de code débutent dans un environnement de staging. L’agent ne modifie jamais vos fichiers originaux à l’aveugle.
2. Revue ligne par ligne : Avant chaque écriture sur le disque dur, un panneau d’inspection liste les diffs textuels. Vous validez ou refusez chaque bloc de code manuellement.
3. Points de restauration : Si le résultat dérive ou plante vos tests unitaires, vous rétablissez l’état antérieur en un clic pour tenter une approche alternative avec un autre modèle.
4. Localisation des données : Vos dépôts, historiques de requêtes et fichiers restent stockés sur votre disque. Cindy ne siphonne pas l’intégralité de vos projets vers le cloud.
Les décisions irréversibles nécessitent systématiquement une confirmation humaine explicite. Si l’agent hésite sur la portée d’une commande destructive, il s’interrompt et vous interroge dans le terminal de contrôle.
Pilotage distant : mobile et messageries d’entreprise
Vous n’avez pas besoin de rester assis devant votre écran pour suivre Cindy. L’écosystème comprend deux extensions d’usage pratique :
Le contrôle mobile vous permet d’inspecter l’avancement d’un refactoring depuis votre smartphone. Si l’agent réclame une autorisation sur une commande sensible, une notification s’affiche sur votre téléphone pour valider l’action à distance.
L’intégration collaborative fonctionne avec Slack ou Feishu. En mentionnant Cindy dans un canal de discussion dédié, vous lui confiez une mission précise. La tâche s’exécute sur votre machine personnelle restée au bureau, et Cindy renvoie le compte-rendu ou la pull request directement dans le fil de discussion.
Analyse de la télémétrie et vie privée
Le binaire officiel intègre par défaut la solution TapDB pour mesurer des métriques d’usage agrégées (type de matériel, version du système d’exploitation et identifiant de compte si vous êtes connecté). Aucun extrait de code, aucune conversation et aucun chemin de fichier n’est envoyé à ces serveurs statistiques. Les rapports de plantage restent aussi stockés localement.
Si vous compilez le client depuis les sources pour des raisons strictes de conformité, vous pouvez désactiver complètement ce traceur :
- Sur mobile : TapDB est inactif par défaut tant que les identifiants
clientIdetclientTokenne sont pas passés au build dansapps/mobile/src/analytics/mobileTapdb.ts. - Sur desktop : supprimez simplement l’appel
initTapdb()situé dansapps/desktop/src/renderer/index.tsx. Le dossierapps/desktop/src/renderer/analytics/peut être retiré du flux de compilation.
Règles de contribution et extensions internes
Pour étendre Cindy, plusieurs documents d’architecture guident le développement dans le dossier docs/ :
AGENTS.mdrégit les contrats d’exécution et les frontières strictes entre modules.docs/dev-rules/détaille le moteur d’orchestration Orca utilisé pour faire collaborer les agents.docs/auth-realm-routing.mdexplique le routage des sessions SSO d’entreprise.DESIGN.mdrecense les jetons graphiques et l’interface utilisateur.
La gestion des extensions (Skill Hub) fait l’objet d’une transition technique documentée : les versions de production exploitent encore skillhubApiBaseUrl, tandis que la branche de développement utilise cindySkillHubApiBaseUrl. Le client moderne refuse délibérément de basculer vers l’ancien proxy XD si la nouvelle variable est absente.
Toute contribution sous forme de Pull Request vers la branche principale impose la signature de vos commits (DCO, avec git commit -s). Les mainteneurs refusent les CLA privatifs au profit de la licence Apache-2.0 standard.
Limites connues et points de vigilance
Cindy n’est pas exempte de contraintes techniques. Le backend central des services hébergés reste fermé, ce qui oblige à dépendre de l’infrastructure de l’éditeur si vous désirez utiliser leurs fonctions cloud prêtes à l’emploi. Le support des versions récentes de pnpm bloque net à la branche 10.x, risquant de perturber les machines déjà migrées sur pnpm 11.
Certains modules comme la place de marché de plugins ou le partage d’aptitudes en équipe restent en cours de finalisation. Néanmoins, pour qui cherche un agent d’ingénierie locale capable de combiner Claude Code et Codex sans abandonner sa vie privée, le code source de Cindy fournit une base opérationnelle solide dès aujourd’hui.