How to Use Paperclip AI to Manage Your AI Agents in 2026
If you've been anywhere near the AI developer space this month, you've seen Paperclip everywhere. 26,000 GitHub stars in two weeks. 3,500 forks. Featured in eWeek, The Neuron, and dozens of YouTube breakdowns.
But most of the coverage tells you what Paperclip is. Very few tell you how to actually use it — and whether it's worth your time.
I run multiple AI agents daily to build Purchy, a receipt and return tracking app. I've had the "20 terminals open, no idea what each one is doing" problem. I've had agents burn through tokens because nobody was watching. So I tested Paperclip to see if it solves these problems for real.
Here's the honest breakdown.
What Paperclip Actually Is (and Isn't)
Paperclip is not a replacement for Claude Code, OpenClaw, Codex, or Cursor. It doesn't write code. It doesn't chat with you.
Paperclip is the management layer that sits on top of those tools. Think of it this way:
- Claude Code = your software engineer
- OpenClaw = your personal assistant
- Paperclip = the company they both work for
It gives your agents an org chart, job titles, budgets, goals, and a single dashboard to monitor everything. If you only use one AI agent, you don't need it. If you use five or more, you probably do.
Setting It Up (Genuinely 5 Minutes)
Option 1: One Command
Open your terminal and run:
npx paperclipai onboard --yes
That's it. It installs everything, creates a local database automatically, and launches a dashboard at http://localhost:3100.
Option 2: Manual Install
git clone https://github.com/paperclipai/paperclip.git
cd paperclip
pnpm install
pnpm dev
Requirements: Node.js 20+ and pnpm 9.15+. No external database needed — it creates an embedded PostgreSQL automatically.
Your First 15 Minutes
Once the dashboard is running, here's what happens:
1. Create Your Company
You'll set a company name and a mission statement. This isn't fluff — every task your agents work on traces back to this mission. When an agent picks up a task, it sees the full chain: mission → goal → project → task.
Example mission: "Build the #1 receipt tracking app and reach 5,000 paying subscribers."
2. Hire Your First Agent (The CEO)
Paperclip starts you with a CEO agent. This is the top of your org chart. The CEO:
- Reviews the company mission
- Recommends which roles to hire next
- Delegates work down the chain
You pick which AI runtime powers the CEO — Claude, GPT, Codex, or any agent that can receive HTTP signals.
3. Approve Hires and Set Budgets
The CEO recommends hiring more agents. You approve each one and set a monthly token budget. When an agent hits its budget, it stops. No exceptions. No surprise $300 bills.
Typical structure:
- CEO → sets strategy, delegates
- CTO → manages technical work
- Engineers → write code (Claude Code, Codex)
- Designer → UI/UX work
- Marketer → content, SEO, social
4. Agents Start Working
Once hired, agents work on a heartbeat schedule. They wake up at set intervals, check for tasks, do the work, and go back to sleep. You control how often each agent checks in.
This is fundamentally different from having an agent running 24/7 burning tokens. It's more like having employees who check their inbox every hour.
The 8 Features That Actually Matter
1. Org Charts That Drive Work
This isn't a pretty diagram — the reporting structure determines how tasks flow. When the CEO creates a project, it delegates to the CTO, who breaks it into tasks for engineers. Work flows down. Reports flow up.
2. Goal Alignment
Every task connects to a project. Every project connects to a goal. Every goal connects to the company mission. Agents don't just know what to do — they know why.
This matters more than you think. When an AI agent has context about why a task matters, it makes better decisions about tradeoffs, priorities, and what to flag for human review.
3. Heartbeat Scheduling
Agents wake on a schedule, check for work, and act. You set the interval per agent. Your CEO might check in every 30 minutes. Your engineers might check in every 2 hours.
4. Budget Controls
Every agent gets a monthly spending limit. Real-time token tracking. When they hit the limit, they stop. You can see exactly how much each agent has spent and on what.
5. Ticket System with Audit Trail
Every conversation is threaded. Every tool call is traced. Every decision is logged. If something goes wrong, you can trace exactly what happened.
6. Multi-Runtime Support
Paperclip works with Claude Code, OpenClaw, Codex, OpenCode, Cursor, bash scripts, or any agent that accepts HTTP signals. Mix and match — your CEO on Claude, your engineers on Codex, your marketer on OpenClaw.
7. Multi-Company Support
One Paperclip installation can run multiple companies with completely separate data, budgets, and audit trails.
8. Governance
You're the board of directors. Approve hires. Override strategy. Pause or terminate any agent at any time. Configuration changes are versioned with rollback.
What's Coming: ClipMart
The team is building ClipMart — a marketplace where you can download pre-built company templates. Think of it like a template store:
- Marketing agency template
- SaaS builder template
- Content studio template
- E-commerce operations template
Pick one, import it into Paperclip, and you have a fully staffed AI company. This hasn't launched yet but it's on the roadmap.
Who Should Actually Use This
Use Paperclip if you:
- Run 3+ AI agents and lose track of what each one is doing
- Have had agents waste money on runaway token usage
- Want persistent task management that survives reboots
- Need to coordinate multiple agents toward one goal
- Want mobile access to monitor your AI operations
Skip Paperclip if you:
- Only use one AI tool for one thing
- Don't need coordination between agents
- Prefer simple terminal-based workflows
The Honest Tradeoffs
What's great:
- Setup is genuinely fast
- The org chart model makes intuitive sense
- Budget controls solve a real problem
- Open source, self-hosted, no vendor lock-in
- 26K stars means active community and rapid development
What's early:
- ClipMart isn't available yet
- Documentation is still growing
- You need some technical comfort with terminal/Node.js
- The "AI CEO recommends hires" workflow is cool but you'll want to customize roles quickly
Getting Started Today
- Run
npx paperclipai onboard --yes - Set your company mission
- Hire your first agents
- Set budgets
- Let them work
The GitHub repo: github.com/paperclipai/paperclip
Building something with AI agents? Purchy helps you track receipts and never miss a return deadline — one less thing to manage while you're managing your AI company.