How arunsanap99/paperclip works
Paperclip is an AI-agent organization manager: users define company goals, organize agents, assign and govern work, then monitor execution and cost. The principal flow runs from the dashboard through the server to persisted work and agent execution, with results and run history available for review. Separate branches cover approvals and budgets, heartbeat-driven operation, workspaces and recovery, agent skills and evaluation, and extensible adapters and integrations. The README documents these capabilities; source excerpts are limited, so links not directly evidenced there are omitted.
Main entry points: app.ts Application server · schema Product data store · agents.ts Agent profiles · approvals.ts Approvals and review
Components 21
Goals and work
- Goals and alignment
packages/db/src/schema/goals.ts - Projects
packages/db/src/schema/projects.ts - Tasks and issues
packages/db/src/schema/issues.ts - Routines and pipelines
packages/db/src/schema/routines.ts
Organization and governance
- Company and agent org
packages/db/src/schema/companies.ts - Agent profiles
packages/db/src/schema/agents.ts - Permissions and connections
packages/db/src/schema/tool_access.ts - Approvals and review
packages/db/src/schema/approvals.ts
Execution runtime
- Heartbeat lifecycle
server/src/services/heartbeat/run-lifecycle.ts - Agent runner
packages/paperclip-runner/src - Provider adapters
packages/adapters - Workspace snapshots
server/src/services/remote-workspace-snapshot-storage.ts - Workspace restoration
server/src/services/git-workspace-restoration.ts
Platform and integrations
- Product data store
packages/db/src/schema - Skills and evaluations
packages/adapters - MCP and plugins
packages/plugins - Run history and costs
packages/db/src/schema/heartbeat_runs.ts
User experience
- Paperclip dashboard
ui/src/App.tsx - Application server
server/src/app.ts
Other components
- Human user
- External agent
Connections 22
- Human user → Paperclip dashboard: manages
README.md - Paperclip dashboard → Application server: requests work
README.md - Application server → Product data store: persists state
- Application server → Agent runner: orchestrates agents
README.md - Agent runner → Provider adapters: uses harnesses
README.md - Provider adapters → External agent: executes
README.md - Application server → Heartbeat lifecycle: runs heartbeats
- Application server → Approvals and review: supports review
README.md - Application server → Workspace snapshots: manages snapshots
- Application server → Workspace restoration: restores workspaces
- Application server → MCP and plugins: supports integrations
README.md - Agent profiles → Product data store: stores profiles
packages/db/src/schema/agents.ts - Company and agent org → Product data store: stores governance
packages/db/src/schema/companies.ts - Goals and alignment → Product data store: stores goals
packages/db/src/schema/issues.ts - Projects → Product data store: stores projects
packages/db/src/schema/projects.ts - Tasks and issues → Product data store: stores tasks
packages/db/src/schema/issues.ts - Routines and pipelines → Product data store: stores routines
packages/db/src/schema/routines.ts - Permissions and connections → Product data store: stores access
packages/db/src/schema/projects.ts - Approvals and review → Product data store: stores approvals
- Heartbeat lifecycle → Run history and costs: records runs
- Skills and evaluations → Agent profiles: trains agents
README.md - Application server → Run history and costs: tracks costs
README.md