Paperclip: Como Gerenciar uma Empresa Individual com Este Framework Open Source

Paperclip é um framework de empresa de uma pessoa só, de código aberto, que orquestra agentes de IA como funcionários: organogramas, orçamentos, agendamento de "batimentos cardíacos", aprovações de governança e um log de auditoria completo. Um comando o inicia localmente. Seus agentes fazem o trabalho; você conduz a reunião do conselho.

Executar uma empresa de uma pessoa só em 2026 não significa mais fazer tudo sozinho – significa dirigir uma equipe de agentes de IA que fazem o trabalho enquanto você se mantém focado na estratégia. O Paperclip é o framework de empresa de uma pessoa só, de código aberto, construído para tornar isso realidade. Ele oferece a fundadores solo um organograma, um sistema de orçamento, uma camada de governança e um rastreador de tarefas para seus agentes de IA, tudo em um painel auto-hospedado. Se você também usa o Apidog para projetar, simular e testar as APIs com as quais seus agentes interagem, o Paperclip completa a pilha: Apidog é o dono do contrato da API, Paperclip é o dono dos agentes que a chamam. Este guia explica exatamente como o Paperclip funciona e como integrá-lo a uma operação de uma pessoa só a partir de hoje.

💡

Obtenha o Apidog (gratuito) antes do seu primeiro "batimento cardíaco" do Paperclip. Incorpore URLs de mock nas descrições das tarefas para que os agentes construam contra contratos perfeitos – custo zero, surpresas zero. Mude para APIs ao vivo mais tarde com os testes do Apidog, pegando qualquer desvio antes que o orçamento queime.

botão

O Que É Paperclip e Por Que o Framework de Empresa de Uma Pessoa Só Importa para Usuários Apidog?

O slogan do Paperclip diz diretamente: "Se OpenClaw é um funcionário, Paperclip é a empresa."

Paperclip é um servidor Node.js e uma interface de usuário React que transforma sua coleção de agentes de IA em uma organização estruturada com cargos, linhas de reporte, orçamentos mensais e metas estratégicas. Não é um chatbot, um gerenciador de prompts ou um construtor de fluxo de trabalho arrasta e solta. É o plano de controle para uma empresa autônoma.

Aqui está o porquê este framework de empresa de uma pessoa só é importante agora.

A maioria dos fundadores solo usando agentes de IA em 2026 está gerenciando o caos. Vinte abas do Claude Code abertas. Nenhum registro de qual agente tocou qual arquivo. Nenhum limite de gasto com tokens. Nenhuma maneira de saber se o agente terminou a tarefa ou se alucinou uma conclusão. O Paperclip corrige tudo isso tratando os agentes da mesma forma que uma empresa real trata os funcionários:

Organograma — agentes têm papéis, títulos e um gerente
Problemas / tarefas — cada parte do trabalho é rastreada com status, prioridade e responsável
Metas — cada tarefa remonta à missão da empresa para que os agentes sempre saibam o porquê
Batimentos cardíacos — agentes acordam em um cronograma, verificam sua caixa de entrada de tarefas, fazem o trabalho, reportam de volta
Orçamentos — limites mensais de gasto de tokens por agente; quando atingem o limite, eles param
Governança — você aprova contratações de agentes e decisões estratégicas importantes antes que sejam executadas

Para equipes que usam Apidog para definir e simular as APIs que seus agentes chamam, Paperclip adiciona a camada de orquestração que falta. Apidog diz ao agente qual é o contrato da API. Paperclip diz ao agente qual trabalho fazer, quando fazê-lo e quanto ele pode gastar.

Por Que Fundadores Solo Estão Escolhendo Este Framework de Empresa de Uma Pessoa Só em Vez da Abordagem Somente Apidog

Apidog é excepcional no design e teste de APIs isoladamente. Mas o design de API é apenas uma camada da execução de um produto. Paperclip lida com o processo circundante: decomposição de metas, atribuição de tarefas, rastreamento de progresso, visibilidade de custos e registro de auditoria. Juntos, Apidog + Paperclip oferecem a um fundador solo um sistema operacional completo para uma empresa de software onde humanos definem a direção e agentes de IA executam.

Recursos Principais do Framework de Empresa de Uma Pessoa Só do Paperclip e Onde o Apidog Se Encaixa

Batimentos Cardíacos: O Loop de Ativação de Agentes Compatível com Apidog

O "batimento cardíaco" é a primitiva de execução central do Paperclip. A cada batimento, um agente:

Chama GET /api/agents/me para confirmar sua identidade
Chama GET /api/companies/:id/issues?status=todo,in_progress para ler sua caixa de entrada de tarefas
Chama GET /api/issues/:id para obter o contexto completo, incluindo a ancestralidade da meta pai
Faz o trabalho (escreve código, chama APIs, gera conteúdo)
Chama PATCH /api/issues/:id com atualização de status e um comentário explicando o que fez

É aqui que a integração Apidog brilha. Se a tarefa envolve chamar uma API externa – digamos, puxar dados de clientes para gerar um relatório semanal – o agente acessa um servidor de mock Apidog durante o desenvolvimento, e então muda para o endpoint ao vivo em produção sem alterar uma única linha de código. A validação de requisição do Apidog detecta qualquer desvio no contrato da API antes que ele silenciosamente quebre o trabalho de um agente.

Organograma e Hierarquia de Metas Apidog como a Camada de API

A hierarquia de metas do Paperclip flui de empresa → equipe → agente → tarefa. Um agente atribuído a uma tarefa sempre recebe sua cadeia ancestral para que um agente júnior saiba que está escrevendo uma postagem de blog como parte de "aumentar o tráfego de SEO" como parte de "atingir US$ 1M de MRR". Este contexto impede que os agentes otimizem localmente em detrimento do objetivo mais amplo.

Dentro desta hierarquia, o Apidog serve como a camada de especificação de API. Você define seus serviços internos no Apidog, publica servidores de mock para cada um, e os agentes referenciam esses endpoints do Apidog em suas descrições de tarefas. Quando a API muda, você atualiza a especificação do Apidog, regera o mock, e cada agente downstream obtém o novo contrato automaticamente.

Aplicação do Orçamento Parando Gastos Descontrolados no Seu Fluxo de Trabalho Apidog

Todo agente no Paperclip tem um campo budgetMonthlyCents. Quando o spentMonthlyCents do agente atinge esse teto, ele para de aceitar tarefas. Sem exceções ou substituições. Para uma empresa de uma pessoa só que opera de forma enxuta, este é o recurso que torna o resto possível – você pode dar a um agente um orçamento de US$ 20/mês e saber com certeza que ele nunca o excederá.

Ao combinar isso com os servidores de mock do Apidog, você pode executar um sprint inteiro de trabalho de agente contra mocks (custo zero de tokens) antes de mudar para provedores de IA ao vivo. A prototipagem é gratuita; a produção é orçada.

Configurando Paperclip como Seu Framework de Empresa de Uma Pessoa Só com Apidog {#setup}

Início Local Sem Configuração Apidog Conecta Imediatamente

Colocar o Paperclip em funcionamento é um único comando:

npx paperclipai onboard --yes

Isso inicializa um banco de dados PostgreSQL incorporado, gera uma chave de criptografia mestra, aplica todas as migrações de banco de dados e inicia o servidor em http://localhost:3100. Nenhum Docker necessário, nenhum serviço externo necessário.

Uma vez em execução, abra a interface, crie uma empresa e defina sua primeira meta:

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

Em seguida, crie seu primeiro agente – por exemplo, um agente "Backend Engineer" que usa o adaptador claude_local:

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

Direcione as tarefas do agente para o seu servidor de mock Apidog. Na descrição da tarefa, referencie a URL da coleção Apidog para que o agente tenha o contrato completo da API disponível como contexto.

Conectando Mocks Apidog a Tarefas de Agentes

No Paperclip, as descrições das tarefas são em markdown rico com contexto ancestral completo. Você pode incorporar sua URL base de mock Apidog diretamente:

## Tarefa: Adicionar paginação ao endpoint /users

**Apidog Mock Base:** http://localhost:4523/m1/123456/users
**Critérios de aceitação:**
- O endpoint aceita parâmetros de consulta `page` e `limit`
- Retorna um envelope `{ data: [], total: 0, page: 1 }`
- Cobertura de testes unitários para casos de borda (page=0, limit>100)

O agente lê isso, chama o mock Apidog para verificar o formato da resposta atual, escreve a implementação e reporta de volta com um comentário.

Executando Agentes, Tarefas e Batimentos Cardíacos no Framework de Empresa de Uma Pessoa Só do Paperclip com Apidog

Gerenciando Problemas Através do Pipeline Paperclip Apidog

A CLI do Paperclip oferece controle total sobre o ciclo de vida das tarefas sem abrir a interface de usuário:

# Criar uma tarefa para um agente implementar um novo endpoint definido no Apidog
pnpm paperclipai issue create \
  --company-id <id> \
  --title "Implementar endpoint POST /webhooks conforme especificação Apidog" \
  --description "Veja a coleção Apidog: http://localhost:4523/..."

# Verificar status da tarefa
pnpm paperclipai issue list --company-id <id> --status in_progress

# Liberar uma tarefa se um agente ficar preso
pnpm paperclipai issue release <issue-id>

Cada mudança de status é registrada no log de atividades imutável para que você sempre saiba exatamente qual agente tocou uma tarefa e o que ele disse.

Governança e Aprovações no Framework de Empresa de Uma Pessoa Só Integrado ao Apidog

O modelo de governança do Paperclip coloca você no papel do conselho. Antes que qualquer agente seja contratado ou qualquer estratégia importante seja aprovada, o Paperclip pode exigir sua aprovação explícita:

# Revisar aprovações pendentes
pnpm paperclipai approval list --company-id <id>

# Aprovar uma nova contratação de agente
pnpm paperclipai approval approve <approval-id> \
  --decision-note "Aprovado. Use o mock do Apidog para o primeiro sprint."

Isso impede que o framework de empresa de uma pessoa só se torne um desastre de autonomia. Agentes propõem; você decide.

Testes, Governança e Controle de Custos em Sua Pilha de Framework de Empresa de Uma Pessoa Só Paperclip + Apidog

Executando a Suíte de Testes Unitários Paperclip Apidog

O Paperclip vem com uma suíte completa de testes unitários alimentada por Vitest e testes de ponta a ponta alimentados por Playwright. Executá-los é simples:

# Executar todos os testes unitários
pnpm test:run

# Executar testes de ponta a ponta
pnpm test:e2e

# Verificação de saúde — verificar se o servidor e o mock do Apidog estão acessíveis
curl http://localhost:3100/api/health

A suíte de testes unitários cobre a lógica de negócios central: transições de estado de problemas, aplicação de orçamento, ciclo de vida de execução do batimento cardíaco e autenticação de agente. Ao adicionar um adaptador personalizado para conectar um novo provedor de IA, a execução da suíte de testes unitários confirma que o comportamento de orquestração existente permanece inalterado.

Em um framework de empresa de uma pessoa só, isso importa mais do que em uma equipe tradicional. Você não tem revisor de código. A suíte de testes unitários e seus testes de contrato Apidog são sua rede de segurança.

A Pilha de Qualidade de Três Camadas: Paperclip + Apidog + Testes Unitários

Um padrão de qualidade prático para fundadores solo:

O Apidog define o contrato da API e executa testes de contrato automatizados a cada push
As issues do Paperclip contêm critérios de aceitação que referenciam a especificação do Apidog
Os testes unitários (Vitest) validam que a implementação corresponde a ambos

Essa abordagem de três camadas significa que um fundador solo obtém a mesma garantia de qualidade que uma equipe de cinco pessoas teria de uma revisão por pares, sem as reuniões.

Conclusão

O Paperclip é o framework de empresa de uma pessoa só, de código aberto, que transforma um fundador solo em uma empresa. Ele traz organogramas, controles orçamentários, governança, alinhamento de metas, agendamento de "batimentos cardíacos" e um registro de auditoria completo para o gerenciamento de agentes de IA – tudo auto-hospedado, todo de código aberto, tudo seu.

Para desenvolvedores que já usam o Apidog para projetar e testar APIs, adicionar o Paperclip completa a pilha. O Apidog lida com o que a API faz. O Paperclip lida com quem a chama, quando, por que e a que custo. Juntos, eles formam um framework de empresa de uma pessoa só que é de nível de produção desde o primeiro dia: seus servidores de mock Apidog impulsionam o desenvolvimento de agentes, seus testes de contrato Apidog validam a saída do agente, e a camada de governança do Paperclip garante que nenhum agente tome uma ação que você não aprovou.

Comece agora:

Inicialize localmente: npx paperclipai onboard --yes
Abra a interface em http://localhost:3100, crie uma empresa e defina sua primeira meta
Adicione um agente com um orçamento de US$ 20/mês e direcione-o para o seu servidor de mock Apidog
Execute pnpm test:run para verificar se a suíte de testes unitários passa antes do seu primeiro "batimento cardíaco" em produção
Aprove a primeira tarefa, observe o agente trabalhar, revise o log de auditoria

A empresa de uma pessoa só não é mais uma metáfora. Com Paperclip e Apidog, é uma arquitetura.

botão

FAQ

O que é Paperclip? Paperclip é um framework de empresa de uma pessoa só, de código aberto – um servidor Node.js e uma interface de usuário React que orquestra agentes de IA com organogramas, orçamentos, agendamento de "batimentos cardíacos" e governança. É o plano de controle para operar uma empresa de software com agentes de IA em vez de funcionários humanos.

Como o Paperclip se integra com o Apidog? O Apidog define os contratos de API com os quais seus agentes trabalham. Você incorpora URLs de mock do Apidog nas descrições de tarefas do Paperclip, os agentes chamam esses mocks durante o desenvolvimento, e os testes de contrato do Apidog validam a implementação final. O Paperclip lida com a orquestração; o Apidog lida com a especificação da API.

O Paperclip é adequado para uma verdadeira empresa de uma pessoa só? Sim. A configuração local sem complicação (npx paperclipai onboard --yes) não requer infraestrutura. Limites de orçamento evitam custos descontrolados. O sistema de "batimento cardíaco" lida com o trabalho recorrente automaticamente. A integração Tailscale permite que você gerencie seus agentes do seu telefone. Ele escala do local para a nuvem com a mesma configuração.

Como executo os testes unitários? Execute pnpm test:run para a suíte de testes unitários Vitest, ou pnpm test:e2e para os testes de ponta a ponta Playwright. Uma verificação de saúde em http://localhost:3100/api/health confirma se o servidor está funcionando corretamente antes de testar.

Quais agentes de IA o Paperclip suporta? O Paperclip suporta Claude (local e via OpenClaw), Codex, Cursor, Gemini, OpenCode e qualquer agente que se comunique via HTTP ou execute como um processo local. O sistema de adaptadores é aberto: se o seu agente puder receber um "batimento cardíaco", ele poderá ser contratado.

O Paperclip é de código aberto? Sim. O Paperclip tem licença MIT e é mantido ativamente em github.com/paperclipai/paperclip. O SDK de plugins, pacotes de adaptadores e definições de habilidades são todos publicados como pacotes NPM com escopo sob @paperclipai/*.