Le problème que Paperclip résout
Si vous avez déjà travaillé avec Claude Code sur plusieurs projets en parallèle, vous connaissez le problème: 10, 15, 20 terminaux ouverts, chacun avec sa propre session, et au bout d’un moment vous ne savez plus qui fait quoi. Vous avez perdu le fil d’une tâche, une session a planté, une autre attend une réponse de votre part depuis des heures.
Paperclip part de ce constat. L’un de ses fondateurs l’a décrit clairement: la proactivité des agents IA ne sert à rien si vous n’avez plus de visibilité sur ce qu’ils font. L’outil répond à ce besoin avec un dashboard unique qui regroupe tous vos agents, toutes leurs tâches, toute leur activité, et une inbox centralisée pour vos approbations.
Lancé début mars 2025, Paperclip a dépassé 36 000 étoiles sur GitHub en quelques semaines. Il est entièrement open source, sous licence MIT, et gratuit à utiliser.
Comment fonctionne Paperclip
Paperclip s’installe localement sur votre machine. Il tourne sur un serveur local (localhost) et ouvre un dashboard dans votre navigateur. Vous pouvez aussi le déployer sur un VPS pour y accéder depuis n’importe où.
Le principe est celui d’une entreprise virtuelle. Vous créez une organisation, vous définissez des agents (CEO, ingénieur, designer, marketeur, etc.), vous leur assignez des objectifs, et ils travaillent. Chaque agent est en réalité une session Claude Code avec ses propres instructions, ses propres skills, et son propre budget de tokens. C’est le pattern multi-agent poussé à son maximum.
La coordination entre agents se fait via un système de tickets. Un agent peut créer un ticket, l’assigner à un autre agent, laisser un commentaire. Vous, vous recevez dans votre inbox uniquement ce qui demande votre approbation: une nouvelle embauche, un changement de direction, un livrable à valider.
Vous pouvez gérer plusieurs entreprises dans le même dashboard. Par exemple, une entreprise pour une partie automatisée de votre business existant, et une autre pour un projet annexe que vous testez.
Installation et premier lancement
L’installation tient en une seule commande à coller dans votre terminal. Rendez-vous sur le site Paperclip ou le dépôt GitHub, cliquez sur "Get started", copiez la commande fournie et exécutez-la. Paperclip télécharge les dépendances, démarre le serveur, et ouvre automatiquement le dashboard dans votre navigateur.
Si vous avez déjà Claude Code configuré sur votre machine avec votre clé API, Paperclip la détecte et se connecte directement. Pas besoin de reconfigurer quoi que ce soit.
Au premier lancement, un écran d’onboarding vous demande de nommer votre entreprise et de définir sa mission. C’est la seule fois où vous passez par cet assistant. Ensuite, tout se gère depuis le dashboard.
Créer une entreprise et ses agents
Une fois l’entreprise créée, vous créez votre premier agent. Par convention, c’est souvent un CEO, mais ce n’est pas obligatoire. Vous choisissez le modèle (Sonnet 4.6, Opus, etc.), vous lancez un test de connexion, et si ça passe, l’agent est opérationnel.
Paperclip propose une première tâche par défaut: "Embauche ton premier ingénieur et crée un plan de recrutement." C’est une bonne façon de voir comment les agents fonctionnent en pratique. Le CEO analyse la mission de l’entreprise, formule un plan, et vous soumet une demande d’approbation dans l’inbox avant de recruter.
Une fois que vous approuvez, le nouvel agent est créé automatiquement avec ses propres fichiers de configuration. Il reçoit les premières tâches du CEO et commence à travailler. Vous pouvez voir l’avancement en temps réel depuis le dashboard.
Pour chaque agent, vous configurez quatre fichiers:
- Agents: comment il interagit avec les autres agents de l’organisation
- Heartbeat: la checklist qu’il exécute à chaque réveil
- Soul: sa personnalité, son ton, ses valeurs de travail
- Tools: les outils qu’il a le droit d’utiliser
Vous pouvez modifier ces fichiers manuellement à tout moment. Par exemple, si vous voulez que votre CEO soit plus prudent sur les dépenses, vous l’ajoutez dans le fichier soul.
Les heartbeats: des agents qui travaillent sans vous
Un heartbeat, c’est un réveil programmé. Vous définissez une fréquence (toutes les 4 heures, 8 heures, 12 heures) et l’agent se réveille automatiquement selon ce calendrier. À chaque réveil, il repart avec un contexte frais: il relit ses tâches en cours, consulte les commentaires, et reprend le travail là où il s’était arrêté.
C’est ce mécanisme qui permet à vos agents de travailler la nuit ou pendant que vous faites autre chose. Vous n’avez pas besoin d’être là pour qu’ils avancent. Vous revenez le matin, vous regardez l’inbox, vous approuvez ce qui doit l’être, et le cycle reprend.
Le fichier heartbeat de chaque agent contient une checklist d’exécution précise. C’est ce qui garantit qu’au réveil, l’agent ne repart pas dans une mauvaise direction: il sait exactement ce qu’il doit vérifier en premier et comment prioriser son travail.
Ajouter des skills à vos agents
Paperclip intègre un système de skills similaire à celui de Claude.ai. Vous pouvez ajouter des skills au niveau de l’entreprise entière, ou au niveau d’un agent spécifique.
Pour ajouter une skill, vous collez simplement l’URL du dépôt GitHub ou le chemin vers le fichier. Paperclip récupère les instructions et les charge dans la configuration de l’agent concerné.
Le site skills.sh propose un catalogue de skills prêtes à l’emploi: design frontend, guidelines web, audit de sécurité, rédaction, etc. La plupart sont gratuites. Quelques précautions s’imposent toutefois: vérifiez la source avant d’installer une skill tierce, même si le site effectue des audits de sécurité.
Par défaut, tous les agents Paperclip ont déjà les skills Paperclip chargées. Ils comprennent donc nativement comment fonctionne l’outil, comment créer des tickets, comment déléguer, sans que vous ayez besoin de leur expliquer. Vous pouvez aussi créer vos propres Claude Skills et les injecter dans chaque agent pour des tâches métier spécifiques.
Routines et automatisations récurrentes
La fonctionnalité Routines (actuellement en bêta) permet de définir des workflows récurrents déclenchés automatiquement. Vous créez une routine, vous définissez la fréquence, vous l’assignez à un agent.
Exemple concret: un agent QA qui vérifie chaque nuit le code de votre projet, contrôle les intégrations, et signale toute exposition de clé API ou faille de sécurité. Une fois la routine créée et activée, elle tourne sans intervention de votre part.
Les routines peuvent être déclenchées de trois façons: selon un calendrier (cron), via un webhook, ou manuellement depuis un terminal. Vous pouvez les activer et les désactiver à tout moment depuis le dashboard.
Importer des entreprises prêtes à l’emploi
Plutôt que de construire votre organisation agent par agent, Paperclip propose des templates d’entreprises préconfigurées à importer directement. Ils sont disponibles dans la section "company" du dépôt GitHub officiel.
Ces templates incluent des équipes complètes avec leurs agents, leurs skills, et leurs instructions déjà configurées. Par exemple, GStack inclut un CEO, un CTO, un ingénieur QA, un ingénieur release et un staff engineer. D’autres templates couvrent des cas plus spécialisés: agence IA, recherche scientifique, développement produit.
Certains templates contiennent jusqu’à 48 agents préconfigurés. Plutôt que de partir de zéro, vous importez une équipe fonctionnelle et vous l’adaptez à votre contexte. C’est une façon rapide de tester Paperclip sur un cas d’usage réel sans passer des heures à configurer chaque agent.
Configurer Claude Code comme copilote Paperclip
Une pratique qui fait gagner beaucoup de temps: créer un projet Claude Code dédié à Paperclip. Dans ce projet, vous chargez le dépôt GitHub de Paperclip (open source, donc tout est accessible), vous documentez votre configuration actuelle, vos agents, vos secrets, et vos objectifs.
Ce projet devient votre partenaire de configuration. Quand vous ne savez pas comment gérer les variables d’environnement dans Paperclip, quand vous voulez migrer vers un VPS, quand vous souhaitez ajouter un nouvel agent avec une configuration spécifique: vous interrogez ce projet Claude Code et il vous guide étape par étape en connaissant déjà votre setup.
C’est particulièrement utile au démarrage, quand Paperclip est encore un outil inconnu. Au fur et à mesure que vous l’utilisez, vous en avez moins besoin. Mais pour démarrer vite et éviter les erreurs de configuration, c’est difficile de faire mieux.
Paperclip transforme plusieurs sessions Claude Code isolées en une organisation cohérente avec des rôles, des objectifs partagés et une supervision centralisée. Pour des entrepreneurs ou des équipes qui veulent déléguer une partie de leur activité à des agents IA sans perdre le contrôle, c’est aujourd’hui l’un des outils les plus aboutis disponibles gratuitement.
