Paperclip: Run Your AI Agents Like a Company, Not a Pile of Scripts

⬅️ Back to Tools

What it is

Paperclip is a Node.js server and React UI that orchestrates a team of AI agents to run a business. You bring your own agents, assign goals, and track work and costs from one dashboard.

The best one-liner I’ve seen for it comes from the community: “If OpenClaw is an employee, Paperclip is the company.”

It looks like a task manager, but underneath it has org charts, budgets, governance, goal alignment, and agent coordination. You’re not managing pull requests, you’re managing business goals.

How it works

Three steps:

  1. Define the goal. Something like “Build the #1 AI note-taking app to $1M MRR.”
  2. Hire the team. CEO, CTO, engineers, designers, marketers; any bot, any provider.
  3. Approve and run. Review strategy, set budgets, hit go. Monitor from the dashboard.

The agents themselves can be anything: OpenClaw, Claude Code, Cursor, Codex, even plain bash scripts or HTTP endpoints. If it can receive a heartbeat signal, Paperclip can manage it.

The interesting parts

There’s a lot of “AI orchestration” tools out there. What makes Paperclip worth looking at is that it actually thinks about the hard coordination problems instead of just giving you a chat window and hoping for the best.

Org charts. Your agents have a boss, a title, and a job description. The CEO delegates to the CTO, who delegates to engineers. Delegation flows up and down the org chart automatically via heartbeats.

Heartbeats. Agents wake on a schedule, check their work, and act. A content writer might wake every 4 hours to draft posts and edit copy. A social manager wakes every 12 hours to schedule posts and review analytics. You don’t babysit them, instead they do their rounds and report back.

Cost control. Every agent gets a monthly budget. When they hit it, they stop. There’s a soft warning at 80%, hard pause at 100%. No runaway token burns at 3am while you’re asleep. This alone is worth the install if you’ve ever had an agent loop drain your API credits.

Governance. You’re the board of directors. Agents can’t hire new agents without your approval. The CEO can’t execute a strategy you haven’t reviewed. You can pause any agent, reassign any task, adjust any budget, at any time.

Ticket system. Every task is a ticket with a clear owner and thread. Every tool call, API request, and decision is logged. The audit trail is append-only; no edits, no deletions.

Goal alignment. Every task traces back to the company mission. Agents see the “why” behind what they’re doing, not just a ticket title. A WebSocket handler task carries the context that it’s part of shipping collaboration features, which is part of building the #1 note-taking app.

Multi-company. One deployment can run many companies with complete data isolation. You can run a content marketing agency, a crypto trading desk, and a dev agency from the same install; separate agents, separate data, one control plane.

Under the hood

A few technical details that matter:

  • Atomic execution. Task checkout and budget enforcement are atomic, so two agents can’t grab the same task and you can’t accidentally overspend.
  • Persistent agent state. Agents resume the same task context across heartbeats instead of restarting from scratch every time they wake up.
  • Runtime skill injection. Agents can learn Paperclip workflows and project context at runtime, without retraining.
  • Governance with rollback. Config changes are revisioned, and bad changes can be rolled back.
  • Portable company templates. Export and import entire org structures with secret scrubbing. (Clipmart, a marketplace of pre-built company templates, is coming soon.)

Quick start

Open source, MIT licensed, self-hosted. No Paperclip account required.

npx paperclipai onboard --yes

Or manually:

git clone https://github.com/paperclipai/paperclip.git
cd paperclip
pnpm install
pnpm dev

This starts the API server at http://localhost:3100. An embedded PostgreSQL database is created automatically. No setup needed.

Requirements: Node.js 20+, pnpm 9.15+.

For production, point it at your own Postgres and deploy however you like. You can also use Tailscale to access it remotely if you’re a solo entrepreneur.

What it isn’t

Worth calling out because the space is crowded with things that sound similar:

  • Not a chatbot. Agents have jobs, not chat windows.
  • Not an agent framework. It doesn’t tell you how to build agents. It tells you how to run a company made of them.
  • Not a workflow builder. No drag-and-drop pipelines. It models companies; with org charts, goals, budgets, and governance.
  • Not a single-agent tool. If you have one agent, you probably don’t need this. If you have twenty…you definitely do.

Who’s it for

You’ll find Paperclip useful if:

  • You have a bunch of Claude Code tabs open and lose track of which one is doing what
  • You’re manually gathering context from different places to remind your agent what it’s supposed to be doing
  • You want agents running autonomously 24/7 but still want to audit their work and step in when needed
  • You’ve been burned by runaway token costs and want hard budget limits
  • You have recurring jobs (customer support, social media, reports) and want them to just run on a schedule
  • The mental shift from “I am prompting an AI” to “I am managing a team” appeals to you

That last point, from a Twitter user named yash, nails what makes Paperclip different. It’s not about the AI. It’s about the organizational structure around the AI.

Development 

pnpm dev              # Full dev (API + UI, watch mode)
pnpm dev:server       # Server only
pnpm build            # Build all
pnpm typecheck        # Type checking
pnpm test:run         # Run tests
pnpm db:generate      # Generate DB migration
pnpm db:migrate       # Apply migrations

Links

License

MIT.