Harold KimandPaperclip
98df214917
When reusing a Codex sandbox, the workspace-restore step now performs an auth-merge check before adopting the sandbox's auth.json. The merge fails closed when: - host or sandbox Codex auth is unusable (missing token or account) - the subscription payload shapes differ between host and sandbox - subscription account identities do not match Additional hardening: node absence on PATH during the embedded decision script now exits non-zero instead of silently falling through. Co-change comments link parseAuth (the embedded script) to hasUsableAuthPayload (codex-home.ts) so a future auth-format change cannot silently diverge between the two implementations. Co-Authored-By: Paperclip <noreply@paperclip.ing>
3.6 KiB
Paperclip
Paperclip is the backbone of the autonomous economy. We are building the infrastructure that autonomous AI companies run on. Our goal is for Paperclip-powered companies to collectively generate economic output that rivals the GDP of the world's largest countries. Every decision we make should serve that: make autonomous companies more capable, more governable, more scalable, and more real.
The Vision
Autonomous companies — AI workforces organized with real structure, governance, and accountability — will become a major force in the global economy. Not one company. Thousands. Millions. An entire economic layer that runs on AI labor, coordinated through Paperclip.
Paperclip is not the company. Paperclip is what makes the companies possible. We are the control plane, the nervous system, the operating layer. Every autonomous company needs structure, task management, cost control, goal alignment, and human governance. That's us. We are to autonomous companies what the corporate operating system is to human ones — except this time, the operating system is real software, not metaphor.
The measure of our success is not whether one company works. It's whether Paperclip becomes the default foundation that autonomous companies are built on — and whether those companies, collectively, become a serious economic force that rivals the output of nations.
The Problem
Task management software doesn't go far enough. When your entire workforce is AI agents, you need more than a to-do list — you need a control plane for an entire company.
What This Is
Paperclip is the command, communication, and control plane for a company of AI agents. It is the single place where you:
- Manage agents as employees — hire, organize, and track who does what
- Define org structure — org charts that agents themselves operate within
- Track work in real time — see at any moment what every agent is working on
- Control costs — token salary budgets per agent, spend tracking, burn rate
- Align to goals — agents see how their work serves the bigger mission
- Preserve work context — comments, documents, work products, attachments, and company state stay attached to the work
Architecture
Two layers:
1. Control Plane (this software)
The central nervous system. Manages:
- Agent registry and org chart
- Task assignment and status
- Budget and token spend tracking
- Issue comments, documents, work products, attachments, and company state
- Goal hierarchy (company → team → agent → task)
- Heartbeat monitoring — know when agents are alive, idle, or stuck
It also enforces execution-control semantics such as single-assignee issues, atomic checkout and execution locks, blockers, recovery issues, and workspace/runtime controls.
2. Execution Services (adapters)
Agents run externally and report into the control plane. Adapters connect different execution environments and define how a heartbeat is invoked, observed, and cancelled:
- Local CLI/session adapters — built-in adapters for tools such as Claude Code, Codex, Gemini, OpenCode, Pi, and Cursor
- HTTP/process-style adapters — command or webhook/API integrations for custom runtimes
- OpenClaw gateway — integration for OpenClaw-style remote agents
- External adapter plugins — dynamically loaded adapters installed outside the core app
The control plane doesn't run agents. It orchestrates them. Agents run wherever they run and phone home.
Core Principle
You should be able to look at Paperclip and understand your entire company at a glance — who's doing what, how much it costs, and whether it's working.