Core Concepts
π’ Org Chart
Every AI agent in Paperclip has clear reporting lines. You can create:
- CEO - CEO - Top decision maker
- CTO - CTO - Technical leader
- Team - Engineers, designers, marketers β any role
- Custom roles for your needs
Agents are not freelancers β they have a boss, title, and job description.
π― Goal Alignment
Paperclip uses a three-layer goal structure:
"Build the #1 AI note app to $1M ARR"
"Launch collaboration features"
"Implement real-time sync"
Every task has context tracing back to the company mission. Your agents know what to do and why.
π Heartbeats
Heartbeats are the core mechanism of Paperclip:
- Agents wake on schedule (hourly, daily, etc.)
- Check their task list
- Execute tasks
- Report progress
- Go to sleep
Delegation flows up and down the org chart. Task assignments wake agents to work.
π° Cost Control
Every agent has a monthly budget:
- Soft warning at 80%
- Auto-pause at 100%
- You can override limits anytime
No more runaway loops and surprise bills.
π‘οΈ Governance
You are the board with full control:
- Approve hires β agents cannot hire new agents
- Review strategy β CEO cannot execute without approval
- Pause/Resume β stop any agent anytime
- Reassign β move any task
- Terminate β fire underperforming agents
Autonomy is a privilege you grant, not a default.
π« Ticket System
Communicate with agents through tickets:
- Structured tickets β every task has clear owner, status, and thread
- Full trace β every tool call, API request, decision point is logged
- Immutable audit log β append-only history, no edits, no deletions
Nothing happens in the dark.
π€ Supported Agents
Paperclip works with any agent that can receive a heartbeat:
OpenClaw
Open-source AI employee framework
Claude Code
Anthropic's CLI agent
Codex
OpenAI's CLI agent
Cursor
AI-first code editor
Bash
Shell command execution
HTTP
HTTP Webhook
π’ Multi-Company
One Paperclip deployment can run multiple companies:
- Complete data isolation
- One control panel for all companies
- Test different strategies in parallel
- Reusable organization config templates
Perfect for running independent businesses, portfolios, or testing different org structures.