Cos’è Paperclip AI e perché è nata

Paperclip è un’applicazione open source rilasciata sotto licenza MIT che funge da “ufficio centrale” per più agenti AI. Il progetto, nato il 2 marzo 2026 da Paperclip Labs, Inc., è ospitato su GitHub nel repository paperclipai/paperclip e, al 13 novembre 2026, conta 113 619 stelle e 18 856 fork, numeri notevoli per un progetto di soli otto mesi.

L’obiettivo principale è risolvere il caos generato dall’utilizzo simultaneo di diversi assistenti (Claude Code, Codex, Gemini CLI, Cursor, ecc.) che, senza un coordinatore, aprono una ventina di terminali senza che l’utente sappia chi sta facendo cosa, quanto costa e quali decisioni attendono l’approvazione umana.

Il README del progetto riassume il concetto con una metafora aziendale: «Se OpenClaw è un dipendente, Paperclip è l’azienda». In pratica, Paperclip non scrive codice né risponde ai clienti; lancia semplicemente gli strumenti da riga di comando già installati, registra le loro azioni e li sospende quando il budget è esaurito.

Installazione e requisiti

Paperclip gira sul proprio computer o su un server personale, senza necessità di account, liste d’attesa o servizi cloud. I requisiti minimi sono:

    • Node.js versione 24.11 o successiva
    • Almeno un agente AI già configurato (ad esempio un abbonamento Claude, ChatGPT, Codex, ecc.)

Il software è gratuito; i costi sono esclusivamente quelli degli agenti, pagati al rispettivo fornitore.

Una volta installato, è possibile avviare Paperclip con un semplice comando npm start e accedere all’interfaccia React tramite http://localhost:3000.

Architettura e flusso di lavoro

Ruoli, budget e responsabilità

Ogni agente ha un ruolo definito, un responsabile (una persona o un altro agente) e un budget. Il budget può essere impostato a livello di azienda, agente o progetto e, per impostazione predefinita, Paperclip avvisa all’80 % di utilizzo e sospende l’attività al 100 %.

Ciclo di vita di un compito

Il processo di gestione di un compito è suddiviso in sei fasi, illustrate nella documentazione ufficiale:

    • Task: creazione del compito con un unico assegnatario, thread di commenti, documenti e collegamenti a progetto/obiettivo. Il compito viene “bloccato” all’avvio per evitare duplicazioni.
    • Wake‑up: l’agente si attiva quando riceve il compito, quando qualcuno commenta, su comando “Wake now” o tramite routine programmata.
    • Agent Run: l’agente lavora in un git worktree isolato, genera una pull request e il diff appare direttamente nel task.
    • Review: il lavoro passa in “In Review”. Il revisore è una persona o un agente diverso da quello che ha eseguito il lavoro.
    • Done / Changes Requested: se approvato, il compito è completato; altrimenti ritorna all’agente con le modifiche richieste.
    • Budget & Routine: il consumo viene registrato; le routine sono lavori ricorrenti che generano nuovi compiti automaticamente.

Funzionalità chiave

Gestione dei worktree

Per evitare conflitti, ogni compito può operare su un git worktree separato, attivabile tramite l’opzione Isolated Workspaces. Questa funzione, elencata tra le sperimentali, permette a più agenti di modificare lo stesso repository senza sovrascrivere le modifiche altrui.

Revisione e approvazione

La revisione è obbligatoria se configurata. Il revisore non può essere lo stesso agente che ha completato il lavoro, garantendo un controllo di qualità indipendente. I commenti di revisione rimangono nel thread del compito, creando una cronologia trasparente.

Monitoraggio dei costi

Paperclip visualizza in tempo reale il costo accumulato per ciascun agente, progetto o per l’intera azienda, consentendo di intervenire prima che il budget venga superato. Le soglie di avviso (80 %) e di pausa (100 %) sono personalizzabili.

Scenario d’uso tipico: sviluppo software

Un tipico flusso di lavoro prevede:

    • Creazione di un compito, ad esempio “Correggi il redirect del login”.
    • Assegnazione a un agente di programmazione (Claude Code o Codex).
    • L’agente apre una pull request nel repository, implementa la correzione e segnala il completamento.
    • Il compito passa in revisione; un collega o un agente di revisione verifica il diff e approva o richiede modifiche.
    • Una volta approvato, il compito è marcato “Done”.

Lo stesso schema può essere adottato per assistenza clienti, marketing o altre attività, mantenendo sempre la separazione tra chi esegue il lavoro e chi lo approva.

Confronto con altre soluzioni

Molti strumenti desktop per agenti AI in parallelo risolvono solo l’aspetto visivo, creando più finestre o sessioni, ma non offrono un’organizzazione strutturata di responsabilità, revisione e controllo dei costi. Paperclip colma questa lacuna introducendo:

    • Un organigramma con ruoli e permessi
    • Thread di commenti condivisi per ogni compito
    • Gestione centralizzata del budget
    • Visibilità completa su tutti i thread e la cronologia

Configurazione di agenti e variabili d’ambiente

Gli agenti richiedono chiavi API per servizi esterni (motori di ricerca, email, ecc.). Queste chiavi vengono inserite come variabili d’ambiente specifiche per ciascun agente, garantendo che le credenziali rimangano segrete e che ogni agente abbia accesso solo agli strumenti necessari, proprio come un dipendente reale.

Paperclip non è un chatbot; l’interazione avviene tramite la creazione di task (simili a issue) e l’assegnazione a un agente, senza conversazioni libere.

Quali agenti sono supportati

Il README elenca i seguenti strumenti compatibili:

    • OpenClaw
    • Claude Code
    • Codex
    • Cursor (versione cloud inclusa)
    • Gemini CLI
    • OpenCode
    • Pi

Poiché Paperclip non fornisce propri modelli, è possibile aggiungere qualsiasi agente che esponga un’interfaccia da riga di comando, ampliando così l’ecosistema in base alle proprie esigenze.

Primo avvio e organizzazione aziendale

I tutorial più diffusi suggeriscono di creare una “azienda” virtuale con una missione di alto livello, ad esempio “Preparare ogni giorno una newsletter tech”. Si assume quindi un agente “CEO” che legge l’obiettivo e propone assunzioni successive (responsabile tecnico, marketing, ecc.). L’utente agisce come consiglio di amministrazione, approvando manualmente ogni nuova assunzione a meno che non venga disattivata l’opzione di approvazione automatica.

I compiti sono visualizzati in una bacheca Kanban con colonne: Da fare, In corso, In revisione, Bloccato, Fatto e Annullato. La colonna “Bloccato” è particolarmente importante perché indica i compiti fermati per mancanza di permessi o per altre dipendenze esterne.

Conclusioni

Paperclip AI rappresenta una soluzione completa per chi utilizza più agenti AI in parallelo, fornendo un’interfaccia centralizzata per assegnare, monitorare e revisionare i compiti, tenendo sotto controllo i costi e garantendo trasparenza tra tutti i membri del team, umani o artificiali. Grazie alla sua natura open source, è facilmente estendibile e adattabile a diversi scenari, dal sviluppo software al marketing, passando per il supporto clienti.