Le probleme que Paperclip resout
Si vous avez deja travaille avec Claude Code sur plusieurs projets en parallele, vous connaissez le probleme : 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 tache, une session a plante, une autre attend une reponse de votre part depuis des heures.
Paperclip part de ce constat. L'un de ses fondateurs l'a decrit clairement : la proactivite des agents IA ne sert a rien si vous n'avez plus de visibilite sur ce qu'ils font. L'outil repond a ce besoin avec un dashboard unique qui regroupe tous vos agents, toutes leurs taches, toute leur activite, et une inbox centralisee pour vos approbations.
Lance debut mars 2025, Paperclip a depasse 36 000 etoiles sur GitHub en quelques semaines. Il est entierement open source, sous licence MIT, et gratuit a 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 deployer sur un VPS pour y acceder depuis n'importe ou.
Le principe est celui d'une entreprise virtuelle. Vous creez une organisation, vous definissez des agents (CEO, ingenieur, designer, marketeur, etc.), vous leur assignez des objectifs, et ils travaillent. Chaque agent est en realite une session Claude Code avec ses propres instructions, ses propres skills, et son propre budget de tokens.
La coordination entre agents se fait via un systeme de tickets. Un agent peut creer un ticket, l'assigner a 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 a valider.
Vous pouvez gerer plusieurs entreprises dans le meme dashboard. Par exemple, une entreprise pour une partie automatisee 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 a coller dans votre terminal. Rendez-vous sur le site Paperclip ou le depot GitHub, cliquez sur "Get started", copiez la commande fournie et executez-la. Paperclip telecharge les dependances, demarre le serveur, et ouvre automatiquement le dashboard dans votre navigateur.
Si vous avez deja Claude Code configure sur votre machine avec votre cle API, Paperclip la detecte et se connecte directement. Pas besoin de reconfigurer quoi que ce soit.
Au premier lancement, un ecran d'onboarding vous demande de nommer votre entreprise et de definir sa mission. C'est la seule fois ou vous passez par cet assistant. Ensuite, tout se gere depuis le dashboard.
Creer une entreprise et ses agents
Une fois l'entreprise creee, vous creez votre premier agent. Par convention, c'est souvent un CEO, mais ce n'est pas obligatoire. Vous choisissez le modele (Sonnet 4.6, Opus, etc.), vous lancez un test de connexion, et si ca passe, l'agent est operationnel.
Paperclip propose une premiere tache par defaut : "Embauche ton premier ingenieur et cree un plan de recrutement." C'est une bonne facon 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 cree automatiquement avec ses propres fichiers de configuration. Il recoit les premieres taches du CEO et commence a travailler. Vous pouvez voir l'avancement en temps reel 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 execute a chaque reveil
- Soul : sa personnalite, son ton, ses valeurs de travail
- Tools : les outils qu'il a le droit d'utiliser
Vous pouvez modifier ces fichiers manuellement a tout moment. Par exemple, si vous voulez que votre CEO soit plus prudent sur les depenses, vous l'ajoutez dans le fichier soul.
Les heartbeats : des agents qui travaillent sans vous
Un heartbeat, c'est un reveil programme. Vous definissez une frequence (toutes les 4 heures, 8 heures, 12 heures) et l'agent se reveille automatiquement selon ce calendrier. A chaque reveil, il repart avec un contexte frais : il relit ses taches en cours, consulte les commentaires, et reprend le travail la ou il s'etait arrete.
C'est ce mecanisme qui permet a vos agents de travailler la nuit ou pendant que vous faites autre chose. Vous n'avez pas besoin d'etre la pour qu'ils avancent. Vous revenez le matin, vous regardez l'inbox, vous approuvez ce qui doit l'etre, et le cycle reprend.
Le fichier heartbeat de chaque agent contient une checklist d'execution precise. C'est ce qui garantit qu'au reveil, l'agent ne repart pas dans une mauvaise direction : il sait exactement ce qu'il doit verifier en premier et comment prioriser son travail.
Ajouter des skills a vos agents
Paperclip integre un systeme de skills similaire a celui de Claude.ai. Vous pouvez ajouter des skills au niveau de l'entreprise entiere, ou au niveau d'un agent specifique.
Pour ajouter une skill, vous collez simplement l'URL du depot GitHub ou le chemin vers le fichier. Paperclip recupere les instructions et les charge dans la configuration de l'agent concerne.
Le site skills.sh propose un catalogue de skills pretes a l'emploi : design frontend, guidelines web, audit de securite, redaction, etc. La plupart sont gratuites. Quelques precautions s'imposent toutefois : verifiez la source avant d'installer une skill tierce, meme si le site effectue des audits de securite.
Par defaut, tous les agents Paperclip ont deja les skills Paperclip chargees. Ils comprennent donc nativement comment fonctionne l'outil, comment creer des tickets, comment deleguer, sans que vous ayez besoin de leur expliquer.
Routines et automatisations recurrentes
La fonctionnalite Routines (actuellement en beta) permet de definir des workflows recurrents declenches automatiquement. Vous creez une routine, vous definissez la frequence, vous l'assignez a un agent.
Exemple concret : un agent QA qui verifie chaque nuit le code de votre projet, controle les integrations, et signale toute exposition de cle API ou faille de securite. Une fois la routine creee et activee, elle tourne sans intervention de votre part.
Les routines peuvent etre declenchees de trois facons : selon un calendrier (cron), via un webhook, ou manuellement depuis un terminal. Vous pouvez les activer et les desactiver a tout moment depuis le dashboard.
Importer des entreprises pretes a l'emploi
Plutot que de construire votre organisation agent par agent, Paperclip propose des templates d'entreprises preconfigurees a importer directement. Ils sont disponibles dans la section "company" du depot GitHub officiel.
Ces templates incluent des equipes completes avec leurs agents, leurs skills, et leurs instructions deja configurees. Par exemple, GStack inclut un CEO, un CTO, un ingenieur QA, un ingenieur release et un staff engineer. D'autres templates couvrent des cas plus specialises : agence IA, recherche scientifique, developpement produit.
Certains templates contiennent jusqu'a 48 agents preconfigures. Plutot que de partir de zero, vous importez une equipe fonctionnelle et vous l'adaptez a votre contexte. C'est une facon rapide de tester Paperclip sur un cas d'usage reel sans passer des heures a configurer chaque agent.
Configurer Claude Code comme copilote Paperclip
Une pratique qui fait gagner beaucoup de temps : creer un projet Claude Code dedie a Paperclip. Dans ce projet, vous chargez le depot 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 gerer les variables d'environnement dans Paperclip, quand vous voulez migrer vers un VPS, quand vous souhaitez ajouter un nouvel agent avec une configuration specifique : vous interrogez ce projet Claude Code et il vous guide etape par etape en connaissant deja votre setup.
C'est particulierement utile au demarrage, quand Paperclip est encore un outil inconnu. Au fur et a mesure que vous l'utilisez, vous en avez moins besoin. Mais pour demarrer vite et eviter les erreurs de configuration, c'est difficile de faire mieux.
Paperclip transforme plusieurs sessions Claude Code isolees en une organisation coherente avec des roles, des objectifs partages et une supervision centralisee. Pour des entrepreneurs ou des equipes qui veulent deleguer une partie de leur activite a des agents IA sans perdre le controle, c'est aujourd'hui l'un des outils les plus aboutis disponibles gratuitement.