Skip to main content
株式会社オブライト
AI2026-09-2810 min read

Paperclip AI: Open-Source Agent Team Manager (2026)

Paperclip is a free, open-source (MIT) self-hosted app that orchestrates teams of AI agents such as OpenClaw, Claude Code, Codex, and Cursor with an org chart, budgets, and approval gates. Updated Sep 2026.


Paperclip is a free, open-source (MIT), self-hosted app that organizes multiple AI agents — OpenClaw, Claude Code, Codex, Cursor, and more — into a single "company," complete with an org chart, budgets, and human approval gates. It's a Node.js server with a React UI that looks like a task manager on the surface, but underneath runs org charts, budgets, governance, and goal alignment.

It's built by paperclipai, a GitHub organization founded on March 2, 2026. As of this writing (September 28, 2026), the repository has roughly 91,765 stars and 15,816 forks, and it ranked #2 on GitHub's weekly trending list with +7,364 stars in a single week (#3 was Hindsight, an agent memory layer). The latest release is v2026.916.1, shipped 2026-09-21. This article covers Paperclip's main features, installation, basic usage, and how it compares to existing tools, based only on the official README and GitHub repository.

What Is Paperclip? "If OpenClaw Is an Employee, Paperclip Is the Company"

The README frames Paperclip's position with the line: "If OpenClaw is an employee, Paperclip is the company." It isn't a tool to make one agent smarter — it's a control plane for running many agents, across any provider or runtime, as a single organization. The basic flow is described in three steps.

StepWhat happensExample
01 Define the goalState a business goal as text"Build the #1 AI note-taking app to $1M MRR"
02 Hire the teamAssign any bot or provider to a role: CEO, CTO, engineer, designer, marketerClaude Code, Codex, Cursor, OpenClaw, bash/HTTP bots, etc.
03 Approve and runReview the strategy, set budgets, hit go, and monitor from the dashboardThe organization starts working
How Paperclip works — a business goal flows to a CEO agent, which delegates to CTO and marketing agents, coding agents underneath execute tasks on a heartbeat, all governed by a budget cap and a human approval gate

What It Can Do — The Four Pillars

The README argues that four things have to work for an organization of AI agents to actually produce: the tasks, the org, the training, and the infrastructure. Paperclip is built around exactly those four pillars.

PillarBuilt forWhat it covers
Agentic Task Manager — declare intent, agents work, you verifyEveryone, dailyTasks, approvals & review gates; proactive agent coworkers; auditable routines & workflows; verify from diffs, screenshots & tests
Org Chart for Agents — roles, permissions & boundariesManagersMixed human + agent org chart; responsibilities, delegation, specialization; governance over who can do what; scoped secrets & company boundaries
Agent Employee Training — design, train & evaluate AI employeesEnablersSkill Studio & shared org-wide skills; evals & saved test runs; active learning loops & quality metrics; performance reviews for agents
Agentic OS — the infrastructure that makes the work runIT & platformCross-provider runtime; sandboxing, integrations & MCP servers; SSO, GRC, RBAC & cost controls; data privacy and internal trace collection

Key Features

FeatureWhat it does
Bring Your Own AgentAny agent, any runtime, one org chart. If it can receive a heartbeat, it's hired
Goal AlignmentEvery task traces back to the organization mission, so agents know what to do and why
HeartbeatsAgents wake on a schedule, check work, and act; delegation flows up and down the org chart
Cost ControlMonthly budgets per agent; when they hit the limit, they stop
Multi-OrganizationOne deployment, many organizations, with complete data isolation
Ticket SystemEvery conversation traced, every decision explained, with full tool-call tracing and an immutable audit log
GovernanceApprove hires, override strategy, pause or terminate any agent at any time
Org ChartHierarchies, roles, and reporting lines — agents get a boss, a title, and a job description
Mobile ReadyMonitor and manage autonomous businesses from anywhere

Three points the README calls out specifically: atomic execution (task checkout and budget enforcement are atomic, so there's no double-work and no runaway spend), persistent agent state (agents resume the same task context across heartbeats instead of restarting from scratch), and governance with rollback (approval gates are enforced, config changes are revisioned, and bad changes can be rolled back safely).

Installation and Pricing

ItemDetail
Developerpaperclipai (GitHub org, founded 2026-03-02)
License / priceMIT, open source, free. No Paperclip account required for self-hosting
ImplementationNode.js server + React UI
RequirementsNode.js 24.11+, pnpm 9.15+ (for manual setup)
DatabaseAn embedded PostgreSQL database is created automatically — no setup required; external object storage providers are also supported
Latest versionv2026.916.1 (2026-09-21) — a patch fixing the chat composer's send button
Homepagepaperclip.ing (docs at docs.paperclip.ing)

The official installer is the recommended path — download the checksum-verified shell script and run it.

curl -fsSLO https://paperclip.ing/install.sh
curl -fsSLO https://paperclip.ing/install.sh.sha256
sha256sum -c install.sh.sha256   # macOS: shasum -a 256 -c install.sh.sha256
bash install.sh

The installer ensures Node.js 24.11+ is available, installs a managed Paperclip CLI under ~/.paperclip/cli, and starts interactive onboarding; it can also run as a background service on supported Linux and macOS systems. To try it without a permanent install, use the npx onboarding command.

npx --registry https://registry.npmjs.org paperclipai onboard --yes

For an isolated instance already initialized with a CEO agent, use test-drive. It stays in the foreground, never installs a service or creates a first task, and only opens the browser once setup succeeds.

ANTHROPIC_API_KEY=... npx paperclipai test-drive
OPENAI_API_KEY=... npx paperclipai test-drive --harness codex
OPENROUTER_API_KEY=... npx paperclipai test-drive \
  --harness opencode \
  --model openrouter/anthropic/claude-sonnet-4.5

For a manual setup, clone the repository and run pnpm install && pnpm dev. This starts the API server at http://localhost:3100, with an embedded PostgreSQL database created automatically.

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

How to Use It — The Shortest Path

- Declare a goal: write down what you want to achieve, as text
- Hire agents: assign Claude Code, Codex, Cursor, OpenClaw, or any agent you like to roles such as CEO, CTO, or engineer (bring your own agent)
- Approve the strategy: review what the CEO agent proposes and set budget caps
- Hit go: agents wake on their heartbeat schedule and work through ticketed tasks
- Monitor from the dashboard or your phone: check diffs, screenshots, and test results, pausing or approving as needed

Recurring work — customer support, social posts, reports — can be automated with Routines, triggered by cron, webhook, or API calls, so nothing needs a manual kickoff each time. Plugins let you extend Paperclip with new tools and UI without forking it. For related agent-infrastructure background, see the Claude Code Complete Guide 2026 and the MCP roadmap breakdown.

How It Differs From Existing Tools

PaperclipOrcaCrewAIOpenClaw
PositioningA control plane that runs a "company" of multiple agentsAn ADE that runs coding agents in parallel git worktrees within one repoA Python framework for defining multi-agent orchestration in codeAn autonomous AI agent itself (the "employee")
Unit of workAn organization (many projects, many agents)Tasks within a single code repositoryA crew of role-based agentsA single agent
FocusOrg chart, budgets, approval gates, governanceWorktree isolation, diff review, in-app browserCoding the coordination logic between agentsExecuting individual tasks and conversations
License / priceMIT, free (self-hosted)MIT, free (desktop app)MIT, free library (paid Enterprise tier exists)MIT (Copyright OpenClaw Foundation), free to run. Runs locally; cost depends on your connected LLM provider's API usage
Best fitCoordinating many agents to run a business, with a human overseeingTrying one coding task with several agents in parallelDevelopers who want to define agent roles and flow in codeIndividuals or small teams delegating work to a single agent

Orca is a development environment (ADE) that runs multiple coding agents like Claude Code and Codex in parallel git worktrees — it has no heartbeats, budgets, or approval gates like Paperclip. See the full Orca guide for a tool focused on parallel review of a single coding task. CrewAI is a Python framework for coding the coordination and role logic between agents; it doesn't ship a human approval gate or org-chart UI the way Paperclip does out of the box. OpenClaw is an autonomous AI agent itself — in the README's own metaphor, closer to "the employee Paperclip hires." See What Is OpenClaw? for its basics.

Things to Watch For, and Who It's For

- Paperclip doesn't run agents itself — contracts, API keys, and authentication for Claude Code, Codex, OpenClaw, and any other agent are your own responsibility (bring your own agent)
- The README itself says "if you have one agent, you probably don't need Paperclip. If you have twenty, you definitely do" — it can be overkill for light, single-agent use
- It explicitly states it is not a workflow builder, prompt manager, or code review tool, so drag-and-drop pipelines and the review process itself are out of scope
- Company Portability lets you export/import an entire organization (agents, skills, projects, routines, issues), but check its secret-scrubbing and collision-handling behavior before relying on it
- Runaway-cost protections exist (budget auto-stop, atomic checkout), but final billing should always be confirmed in each agent provider's own console

It suits individuals or teams already running several AI agents who have lost track of what each one is doing, can't predict cost, or want a real approval process. If you're only using a single coding agent, a lighter tool like Orca above may be a better fit.

FAQ

Is Paperclip free to use?

The app itself is open source under MIT and can be self-hosted without a Paperclip account. However, the agents you hire — Claude Code, Codex, and so on — still need their own subscriptions or API keys, arranged separately.

Which agents can it work with?

The official README lists OpenClaw, Claude Code, Codex, and Cursor, plus bots reachable via bash or HTTP/webhook, summarizing it as: if it can receive a heartbeat, it's hired.

Do I need to set up a database myself?

No. Running pnpm dev automatically creates an embedded PostgreSQL database.

Is it worth it for individual use?

The README says if you only use one agent, you probably don't need Paperclip — but it's built for situations like having 20 Claude Code terminals open and losing track of what each is doing. Whether it's worth it depends on how many agents you run and how hard they are to manage.

Can it prevent runaway costs?

You can set a monthly budget per agent, and agents stop automatically once they hit the limit. According to the README, task checkout and budget enforcement are atomic, which is designed to prevent double-work and the overspend that comes with it.

Summary

Rather than making a single agent smarter, Paperclip is a control plane for running multiple agents as an organization — goal-setting, delegation, execution, budgets, and human approval gates all live in one dashboard, aimed at the chaos of manually managing twenty-plus agent sessions.

That said, contracts and authentication for the agents themselves remain your responsibility, and it can be overkill for single-agent use. Trying a small organization with the test-drive command first, then tightening budget and approval rules as you scale, looks like the reasonable path to a full rollout.

Sources

Feel free to contact us

Contact Us