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

Paperclip é um framework open source para empresas de uma pessoa só: ele orquestra agentes de IA como funcionários, implementando organogramas, orçamentos, agendamento de "batimentos cardíacos", governança com aprovações e um log de auditoria completo. Basta um comando para rodar localmente. Os agentes fazem o trabalho; você gerencia o board.

Experimente o Apidog 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.

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

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

Paperclip é um servidor Node.js com UI React que transforma sua coleção de agentes de IA em uma organização estruturada: cargos, linhas de reporte, orçamentos mensais e metas estratégicas. Não é chatbot, não é gerenciador de prompts, não é builder de workflow drag-and-drop. É plano de controle para empresa autônoma.

Por que isso importa? Porque fundadores solo com agentes de IA vivem o caos: múltiplos agentes, zero rastreio de quem fez o quê, controle de custos inexistente, nenhuma garantia de entrega do que foi pedido. O Paperclip resolve:

• Organograma: agentes têm papéis e gerentes
• Tarefas: cada parte do trabalho rastreada com status, prioridade e responsável
• Metas: cada tarefa ligada à missão maior da empresa
• Batimentos cardíacos: agentes acordam, checam caixa de entrada de tarefas, executam, reportam
• Orçamentos: limites mensais para tokens por agente
• Governança: você aprova contratações e decisões importantes

Para times que usam Apidog para definir/simular APIs, Paperclip é a camada de orquestração. Apidog define o contrato da API; Paperclip define trabalho, cronograma e orçamento dos agentes.

Por Que Fundadores Solo Estão Escolhendo Paperclip + Apidog

Apidog é excelente para design e teste de APIs. Mas só isso não cobre o ciclo completo de execução de produto. Paperclip gerencia decomposição de metas, distribuição de tarefas, progresso, custos e auditoria. Usando ambos, você tem um OS completo para sua empresa de software: humanos definem direção, agentes de IA executam.

Recursos Principais do Paperclip e Onde o Apidog Se Encaixa

Batimentos Cardíacos: Loop de Execução e Integração Apidog

O "batimento cardíaco" é a rotina central do Paperclip. Em cada batimento, um agente:

1. Chama GET /api/agents/me para confirmar identidade
2. Chama GET /api/companies/:id/issues?status=todo,in_progress para ler tarefas
3. Chama GET /api/issues/:id para contexto completo da tarefa/meta
4. Executa (escreve código, chama APIs, gera conteúdo)
5. Chama PATCH /api/issues/:id para atualizar status e comentar

Se a tarefa envolve API externa, o agente usa um servidor de mock Apidog durante dev e troca para endpoint ao vivo em produção sem mexer no código. O Apidog valida requisições, evitando que desvios no contrato quebrem o agente.

Organograma e Hierarquia de Metas: Apidog como Camada de API

Metas no Paperclip seguem: empresa → equipe → agente → tarefa. O agente recebe ancestralidade da meta para contextualizar o trabalho – ex: escrever post de blog como parte de "aumentar tráfego SEO" para "atingir US$ 1M de MRR".

No fluxo, Apidog é a camada de especificação de API. Você define serviços no Apidog, publica servers de mock, e referencia esses endpoints nas tarefas do Paperclip. Mudou a API? Atualize Apidog, gere novo mock, e todos agentes recebem o novo contrato.

Aplicação de Orçamento: Controle de Custos Integrado ao Fluxo Apidog

Cada agente tem campo budgetMonthlyCents. Ao atingir o limite, para de aceitar tarefas. Assim, você pode dar US$ 20/mês a um agente e garantir que não passa disso.

Combine com mocks Apidog: execute todo desenvolvimento com custo zero de tokens. Só paga quando troca para IA ao vivo.

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

Início Local Rápido e Conexão Imediata ao Apidog

Inicie Paperclip com:

npx paperclipai onboard --yes

Isso inicializa banco PostgreSQL embutido, chave de criptografia, migrações e servidor em http://localhost:3100. Nada de Docker ou serviços externos.

Abra a interface, crie empresa e defina a meta:

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

Adicione um agente (exemplo, Backend Engineer com adaptador claude_local):

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

Direcione tarefas para seu mock server Apidog. Na descrição da tarefa, referencie a URL da coleção Apidog para incluir o contrato da API.

Conectando Mocks Apidog a Tarefas dos Agentes

No Paperclip, descrições de tarefas aceitam markdown e contexto. Incorpore sua base do mock Apidog:

## 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ê, chama o mock Apidog, implementa e reporta.

Executando Agentes, Tarefas e Batimentos Cardíacos com Paperclip + Apidog

Gerenciamento de Tarefas via CLI

Controle o ciclo de vida das tarefas via CLI Paperclip:

# Criar tarefa para agente implementar 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/..."

# Consultar tarefas em andamento
pnpm paperclipai issue list --company-id <id> --status in_progress

# Liberar tarefa presa
pnpm paperclipai issue release <issue-id>

Cada status é registrado no log de atividades para auditoria completa.

Governança e Aprovações

Você aprova contratações ou decisões estratégicas pela CLI:

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

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

Agentes propõem, você aprova – autonomia controlada.

Testes, Governança e Controle de Custos na Pilha Paperclip + Apidog

Executando Testes Unitários e E2E

Paperclip traz suíte de testes com Vitest (unitários) e Playwright (E2E):

# Testes unitários
pnpm test:run

# Testes de ponta a ponta
pnpm test:e2e

# Health check – servidor e mock Apidog
curl http://localhost:3100/api/health

Testes cobrem lógica de tarefas, orçamento, ciclo de batimento cardíaco e autenticação. Ao criar adaptador de IA, execute testes para garantir orquestração estável.

Em empresa de uma pessoa só, testes são sua rede de segurança: sem code review, sem QA manual.

Pilha de Qualidade: Paperclip + Apidog + Testes Unitários

Padrão de qualidade prático:

1. Apidog define contratos de API e executa testes de contrato automatizados
2. Paperclip issues contém critérios de aceitação referenciando specs Apidog
3. Testes unitários (Vitest) validam aderência à especificação e fluxo

Assim, você tem garantia de qualidade de uma equipe inteira, sem reuniões ou overhead.

Conclusão

Paperclip é o framework de empresa de uma pessoa só open source que transforma fundadores solo em empresas organizadas: organograma, orçamento, governança, metas, batimentos cardíacos e log de auditoria – tudo self-hosted e seu.

Se você já usa o Apidog para APIs, Paperclip completa sua stack. Apidog cuida do contrato e testes; Paperclip cuida de quem chama, quando, por que e quanto pode gastar. Juntos, formam uma arquitetura de produção para empresas de uma pessoa só: mocks do Apidog aceleram dev, testes de contrato validam agentes, e Paperclip garante governança.

Para começar:

• Rode local: npx paperclipai onboard --yes
• Abra http://localhost:3100, crie empresa e meta
• Adicione agente com orçamento (ex: US$ 20/mês) e aponte para seu mock Apidog
• Execute pnpm test:run antes do primeiro batimento cardíaco em produção
• Aprove a primeira tarefa, veja o agente agir, revise logs

A empresa de uma pessoa só agora é arquitetura – não metáfora. Com Paperclip e Apidog, você cria, testa, controla e escala.

FAQ

O que é Paperclip?

Framework open source de empresa de uma pessoa só – servidor Node.js + UI React que orquestra agentes de IA com organograma, orçamento, batimentos cardíacos e governança.

Como o Paperclip integra com Apidog?

Apidog define contratos de API. Incorpore URLs de mock Apidog nas tarefas do Paperclip; agentes usam esses mocks no desenvolvimento, e testes de contrato Apidog validam a entrega. Paperclip orquestra; Apidog especifica.

É para empresas reais de uma pessoa só?

Sim. Setup local sem complicação (npx paperclipai onboard --yes), controle de custo, batimentos automáticos, integração Tailscale (gestão via mobile). Escala do local para nuvem.

Como executo testes unitários?

pnpm test:run (unitários Vitest), pnpm test:e2e (E2E Playwright). Health check: http://localhost:3100/api/health.

Quais agentes de IA Paperclip suporta?

Claude (local/OpenClaw), Codex, Cursor, Gemini, OpenCode e qualquer agente HTTP/processo local. Adapte via sistema de adaptadores.

O Paperclip é open source?

Sim, licença MIT, mantido em github.com/paperclipai/paperclip. SDK de plugins, adaptadores e habilidades publicados sob @paperclipai/* no NPM.