Paperclip : Comment gérer une entreprise individuelle avec ce framework open source

Paperclip est un framework open source pour entreprise individuelle qui orchestre les agents IA comme des employés : organigrammes, budgets, planification des pulsations, approbations de gouvernance et un journal d'audit complet. Une seule commande le démarre localement. Vos agents font le travail ; vous dirigez la réunion du conseil.

Diriger une entreprise individuelle en 2026 ne signifie plus tout faire soi-même, mais plutôt diriger une équipe d'agents IA qui effectuent le travail pendant que vous vous concentrez sur la stratégie. Paperclip est le framework open source pour entreprise individuelle conçu pour rendre cela possible. Il offre aux fondateurs solitaires un organigramme, un système de budget, une couche de gouvernance et un suivi des tâches pour leurs agents IA, le tout dans un tableau de bord auto-hébergé. Si vous utilisez également Apidog pour concevoir, simuler et tester les API avec lesquelles vos agents interagissent, Paperclip complète la pile : Apidog possède le contrat API, Paperclip possède les agents qui l'appellent. Ce guide explique exactement comment Paperclip fonctionne et comment l'intégrer dès aujourd'hui dans une opération individuelle.

💡

Procurez-vous Apidog (gratuit) avant votre première pulsation Paperclip. Intégrez des URL de maquette dans les descriptions de tâches afin que les agents développent en fonction de contrats parfaits — coût zéro, surprises zéro. Passez aux API réelles plus tard avec les tests Apidog qui détectent toute dérive avant que le budget ne s'épuise.

button

Qu'est-ce que Paperclip et pourquoi le framework d'entreprise individuelle est-il important pour les utilisateurs d'Apidog ?

Le slogan de Paperclip le dit directement : "Si OpenClaw est un employé, Paperclip est l'entreprise."

Paperclip est un serveur Node.js et une interface utilisateur React qui transforme votre collection d'agents IA en une organisation structurée avec des titres, des lignes hiérarchiques, des budgets mensuels et des objectifs stratégiques. Ce n'est pas un chatbot, un gestionnaire d'invites ou un constructeur de flux de travail par glisser-déposer. C'est le plan de contrôle pour une entreprise autonome.

Voici pourquoi ce framework d'entreprise individuelle est important dès maintenant.

La plupart des fondateurs solitaires utilisant des agents IA en 2026 gèrent le chaos. Vingt onglets Claude Code ouverts. Aucune trace de l'agent qui a touché quel fichier. Pas de plafond de dépenses en jetons. Aucun moyen de savoir si l'agent a terminé la tâche ou a halluciné une complétion. Paperclip corrige tout cela en traitant les agents de la même manière qu'une entreprise réelle traite ses employés :

Organigramme — les agents ont des rôles, des titres et un responsable
Problèmes / tâches — chaque élément de travail est suivi avec un statut, une priorité et un responsable
Objectifs — chaque tâche remonte à la mission de l'entreprise afin que les agents sachent toujours le pourquoi
Pulsations — les agents se réveillent selon un horaire, vérifient leur boîte de réception de tâches, effectuent le travail, rendent compte
Budgets — limites de dépenses mensuelles en jetons par agent ; lorsqu'ils atteignent le plafond, ils s'arrêtent
Gouvernance — vous approuvez les embauches d'agents et les décisions stratégiques majeures avant leur exécution

Pour les équipes qui utilisent Apidog pour définir et simuler les API que leurs agents appellent, Paperclip ajoute la couche d'orchestration manquante. Apidog indique à l'agent quel est le contrat API. Paperclip indique à l'agent quel travail faire, quand le faire et combien il est autorisé à dépenser.

Pourquoi les fondateurs solitaires choisissent ce framework d'entreprise individuelle plutôt que l'approche Apidog seule

Apidog est exceptionnel pour la conception et le test d'API en isolation. Mais la conception d'API n'est qu'une couche de la gestion d'un produit. Paperclip gère le processus environnant : décomposition des objectifs, attribution des tâches, suivi des progrès, visibilité des coûts et journalisation d'audit. Ensemble, Apidog + Paperclip offrent à un fondateur solitaire un système d'exploitation complet pour une entreprise de logiciels où les humains définissent la direction et les agents IA exécutent.

Fonctionnalités clés du framework d'entreprise individuelle de Paperclip et où Apidog s'intègre

Pulsations : La boucle d'activation d'agent compatible Apidog

La pulsation est la primitive d'exécution centrale de Paperclip. À chaque pulsation, un agent :

Appelle GET /api/agents/me pour confirmer son identité
Appelle GET /api/companies/:id/issues?status=todo,in_progress pour lire sa boîte de réception de tâches
Appelle GET /api/issues/:id pour obtenir le contexte complet, y compris l'ascendance de l'objectif parent
Effectue le travail (écrit du code, appelle des API, génère du contenu)
Appelle PATCH /api/issues/:id avec une mise à jour de statut et un commentaire expliquant ce qu'il a fait

C'est là que l'intégration d'Apidog brille. Si la tâche implique d'appeler une API externe – par exemple, extraire des données client pour générer un rapport hebdomadaire – l'agent se connecte à un serveur de maquette Apidog pendant le développement, puis passe au point d'accès en direct en production sans changer une seule ligne de code. La validation des requêtes d'Apidog détecte toute dérive dans le contrat API avant qu'elle ne brise silencieusement le travail d'un agent.

Organigramme et Hiérarchie des Objectifs Apidog comme couche API

La hiérarchie des objectifs de Paperclip s'étend de l'entreprise → l'équipe → l'agent → la tâche. Un agent se voyant attribuer une tâche reçoit toujours sa chaîne d'ancêtres afin qu'un agent junior sache qu'il rédige un article de blog dans le cadre de "développer le trafic SEO" et de "atteindre 1M $ de MRR". Ce contexte empêche les agents d'optimiser localement au détriment de l'objectif global.

Au sein de cette hiérarchie, Apidog sert de couche de spécification d'API. Vous définissez vos services internes dans Apidog, publiez des serveurs de maquette pour chacun, et les agents référencent ces points d'accès Apidog dans leurs descriptions de tâches. Lorsque l'API change, vous mettez à jour la spécification Apidog, regénérez la maquette, et chaque agent en aval obtient automatiquement le nouveau contrat.

Contrôle Budgétaire Arrêt des Dépenses Incontrôlées dans Votre Flux de Travail Apidog

Chaque agent dans Paperclip a un champ budgetMonthlyCents. Lorsque le spentMonthlyCents de l'agent atteint ce plafond, il cesse d'accepter des tâches. Pas de dérogations, pas d'exceptions. Pour une entreprise individuelle fonctionnant de manière allégée, c'est la fonctionnalité qui rend le reste possible : vous pouvez donner à un agent un budget de 20 $/mois et savoir avec certitude qu'il ne le dépassera jamais.

Lorsque vous associez cela aux serveurs de maquette d'Apidog, vous pouvez exécuter un sprint entier de travail d'agent contre des maquettes (coût en jetons nul) avant de passer aux fournisseurs d'IA en direct. Le prototypage est gratuit ; la production est budgétisée.

Mise en place de Paperclip comme framework d'entreprise individuelle avec Apidog {#setup}

Démarrage Local Zéro Configuration Apidog se Connecte Immédiatement

Lancer Paperclip ne nécessite qu'une seule commande :

npx paperclipai onboard --yes

Ceci initialise une base de données PostgreSQL embarquée, génère une clé de chiffrement principale, applique toutes les migrations de base de données et démarre le serveur sur http://localhost:3100. Pas de Docker requis, pas de services externes nécessaires.

Une fois démarré, ouvrez l'interface utilisateur, créez une entreprise et définissez votre premier objectif :

"Build the #1 AI-powered API monitoring tool to $1M MRR."

Ensuite, créez votre premier agent – par exemple, un agent "Ingénieur Backend" qui utilise l'adaptateur claude_local :

{
  "adapterType": "claude_local",
  "adapterConfig": {
    "model": "claude-opus-4-6",
    "maxTokens": 4096
  },
  "budgetMonthlyCents": 2000
}

Dirigez les tâches de l'agent vers votre serveur de maquette Apidog. Dans la description de la tâche, référencez l'URL de la collection Apidog afin que l'agent dispose du contrat API complet comme contexte.

Connecter les Maquettes Apidog aux Tâches d'Agent

Dans Paperclip, les descriptions de tâches sont en markdown enrichi avec le contexte complet des ancêtres. Vous pouvez intégrer directement l'URL de base de votre maquette Apidog :

## Task: Add pagination to the /users endpoint

**Apidog Mock Base:** http://localhost:4523/m1/123456/users
**Acceptance criteria:**
- Endpoint accepts `page` and `limit` query params
- Returns `{ data: [], total: 0, page: 1 }` envelope
- Unit test coverage for edge cases (page=0, limit>100)

L'agent lit cela, appelle la maquette Apidog pour vérifier la forme de la réponse actuelle, écrit l'implémentation et rend compte avec un commentaire.

Exécution des Agents, des Tâches et des Pulsations dans le Framework d'Entreprise Individuelle Paperclip avec Apidog

Gérer les Problèmes via le Pipeline Paperclip Apidog

La CLI Paperclip vous donne un contrôle total sur le cycle de vie des tâches sans ouvrir l'interface utilisateur :

# Create a task for an agent to implement a new Apidog-defined endpoint
pnpm paperclipai issue create \
  --company-id <id> \
  --title "Implement POST /webhooks endpoint per Apidog spec" \
  --description "See Apidog collection: http://localhost:4523/..."

# Check task status
pnpm paperclipai issue list --company-id <id> --status in_progress

# Release a task if an agent gets stuck
pnpm paperclipai issue release <issue-id>

Chaque changement de statut est enregistré dans le journal d'activité immuable afin que vous sachiez toujours exactement quel agent a touché une tâche et ce qu'il a dit.

Gouvernance et Approbations dans le Framework d'Entreprise Individuelle Intégré à Apidog

Le modèle de gouvernance de Paperclip vous place dans le rôle du conseil d'administration. Avant qu'un agent ne soit embauché ou qu'une stratégie majeure ne soit approuvée, Paperclip peut exiger votre approbation explicite :

# Review pending approvals
pnpm paperclipai approval list --company-id <id>

# Approve a new agent hire
pnpm paperclipai approval approve <approval-id> \
  --decision-note "Approved. Use Apidog mock for first sprint."

Cela évite que le framework d'entreprise individuelle ne devienne un désastre d'autonomie. Les agents proposent ; vous décidez.

Tests, Gouvernance et Contrôle des Coûts dans Votre Pile de Framework d'Entreprise Individuelle Paperclip + Apidog

Exécuter la Suite de Tests Unitaires Paperclip Apidog

Paperclip est livré avec une suite complète de tests unitaires alimentée par Vitest et des tests de bout en bout alimentés par Playwright. Les exécuter est simple :

# Run all unit tests
pnpm test:run

# Run end-to-end tests
pnpm test:e2e

# Health check — verify the server and Apidog mock are reachable
curl http://localhost:3100/api/health

La suite de tests unitaires couvre la logique métier essentielle : transitions d'état des problèmes, application du budget, cycle de vie des exécutions des pulsations et authentification des agents. Lorsque vous ajoutez un adaptateur personnalisé pour connecter un nouveau fournisseur d'IA, l'exécution de la suite de tests unitaires confirme que le comportement d'orchestration existant est inchangé.

Dans un framework d'entreprise individuelle, cela est plus important que dans une équipe traditionnelle. Vous n'avez pas de relecteur de code. La suite de tests unitaires et vos tests de contrat Apidog sont votre filet de sécurité.

La Pile Qualité à Trois Couches : Paperclip + Apidog + Tests Unitaires

Un modèle de qualité pratique pour les fondateurs solitaires :

Apidog définit le contrat API et exécute des tests de contrat automatisés à chaque push
Les problèmes de Paperclip contiennent des critères d'acceptation qui référencent la spécification Apidog
Les Tests unitaires (Vitest) valident que l'implémentation correspond aux deux

Cette approche à trois couches signifie qu'un fondateur solitaire bénéficie de la même assurance qualité qu'une équipe de cinq personnes obtiendrait de la révision par les pairs, sans les réunions.

Conclusion

Paperclip est le framework open source pour entreprise individuelle qui transforme un fondateur solitaire en une entreprise. Il apporte des organigrammes, des contrôles budgétaires, la gouvernance, l'alignement des objectifs, la planification des pulsations et un journal d'audit complet à la gestion des agents IA – tout auto-hébergé, tout open source, tout à vous.

Pour les développeurs qui utilisent déjà Apidog pour concevoir et tester des API, l'ajout de Paperclip complète la pile. Apidog gère ce que fait l'API. Paperclip gère qui l'appelle, quand, pourquoi et à quel coût. Ensemble, ils forment un framework d'entreprise individuelle de qualité production dès le premier jour : vos serveurs de maquette Apidog alimentent le développement des agents, vos tests de contrat Apidog valident la sortie des agents, et la couche de gouvernance de Paperclip garantit qu'aucun agent n'entreprend une action que vous n'avez pas approuvée.

Commencez :

Amorçage local : npx paperclipai onboard --yes
Ouvrez l'interface utilisateur à http://localhost:3100, créez une entreprise et définissez votre premier objectif
Ajoutez un agent avec un budget de 20 $/mois et dirigez-le vers votre serveur de maquette Apidog
Exécutez pnpm test:run pour vérifier que la suite de tests unitaires passe avant votre première pulsation de production
Approuvez la première tâche, observez l'agent travailler, examinez le journal d'audit

L'entreprise individuelle n'est plus une métaphore. Avec Paperclip et Apidog, c'est une architecture.

button

FAQ

Qu'est-ce que Paperclip ? Paperclip est un framework open source pour entreprise individuelle – un serveur Node.js et une interface utilisateur React qui orchestre les agents IA avec des organigrammes, des budgets, la planification des pulsations et la gouvernance. C'est le plan de contrôle pour gérer une entreprise de logiciels avec des agents IA au lieu d'employés humains.

Comment Paperclip s'intègre-t-il à Apidog ? Apidog définit les contrats API sur lesquels vos agents travaillent. Vous intégrez les URL de maquette Apidog dans les descriptions de tâches Paperclip, les agents appellent ces maquettes pendant le développement, et les tests de contrat d'Apidog valident l'implémentation finale. Paperclip gère l'orchestration ; Apidog gère la spécification de l'API.

Paperclip convient-il à une véritable entreprise individuelle ? Oui. La configuration locale sans configuration (npx paperclipai onboard --yes) ne nécessite aucune infrastructure. Les limites budgétaires empêchent les coûts incontrôlés. Le système de pulsation gère automatiquement le travail récurrent. L'intégration Tailscale vous permet de gérer vos agents depuis votre téléphone. Il s'adapte du local au cloud avec la même configuration.

Comment exécuter les tests unitaires ? Exécutez pnpm test:run pour la suite de tests unitaires Vitest, ou pnpm test:e2e pour les tests de bout en bout Playwright. Une vérification de santé via http://localhost:3100/api/health confirme que le serveur fonctionne correctement avant de tester.

Quels agents IA Paperclip prend-il en charge ? Paperclip prend en charge Claude (local et via OpenClaw), Codex, Cursor, Gemini, OpenCode, et tout agent qui communique via HTTP ou s'exécute comme un processus local. Le système d'adaptateur est ouvert : si votre agent peut recevoir une pulsation, il peut être embauché.

Paperclip est-il open source ? Oui. Paperclip est sous licence MIT et activement maintenu sur github.com/paperclipai/paperclip. Le SDK de plugins, les packages d'adaptateurs et les définitions de compétences sont tous publiés en tant que packages NPM scoped sous @paperclipai/*.