How nathan7453/paperclip works
Paperclip is an open-source control plane for managing teams of AI agents: people define goals, organize agents, assign and review work, and monitor execution and costs. A representative pipeline workflow is visible from the UI or CLI through pipeline APIs and server routes into pipeline services and persisted case data; the UI also presents and edits case documents. The README documents broader capabilities—governance, skills, budgets, and multi-provider execution—that are represented at subsystem level. Some relationships are documented rather than verified in unsampled implementation code.
Main entry points: routes/pipelines.ts Pipeline routes · Pipelines.tsx Pipeline workspace · services/pipelines.ts Pipeline services · authorization.ts Authorization
Components 20
Work orchestration
- Goals and projects
server/src/services - Pipeline routes
server/src/routes/pipelines.ts - Pipeline services
server/src/services/pipelines.ts - Conversation context
server/src/services/pipeline-conversation-context.ts - Case outputs
server/src/services/pipeline-case-outputs.ts - Issue and task service
server/src/services/issues.ts
Organization governance
- Authorization
server/src/services/authorization.ts - Source trust
server/src/services/source-trust.ts - Skills and training
packages/shared - Budgets and costs
packages/db/src/schema
Agent runtime
- Agent adapters
packages/adapters
User interfaces
- Pipeline workspace
ui/src/pages/Pipelines.tsx - Case document editor
ui/src/components/PipelineItemBodyDocument.tsx - Pipeline API client
ui/src/api/pipelines.ts - Pipeline CLI
cli/src/commands/pipelines.ts
Shared platform
- Pipeline case records
packages/db/src/schema/pipeline_cases.ts - Activity history
server/src/services/activity-log.ts - Application database
packages/db/src - HTTP client
ui/src/api/client.ts
Other components
- Human operator
Connections 25
- Human operator → Goals and projects: defines goals
README.md - Human operator → Pipeline workspace: manages work
README.md - Human operator → Pipeline CLI: runs commands
README.md - Goals and projects → Pipeline workspace: aligns work
README.md - Pipeline workspace → Pipeline API client: requests pipeline data
ui/src/pages/Pipelines.tsx - Case document editor → Pipeline API client: loads and saves
ui/src/components/PipelineItemBodyDocument.tsx - Pipeline API client → HTTP client: sends requests
ui/src/api/pipelines.ts - HTTP client → Pipeline routes: calls API
README.md - Pipeline CLI → Pipeline routes: calls pipeline API
cli/src/commands/pipelines.ts - Pipeline routes → Pipeline services: delegates pipeline work
server/src/routes/pipelines.ts - Pipeline routes → Authorization: checks permissions
server/src/routes/pipelines.ts - Pipeline routes → Activity history: records activity
server/src/routes/pipelines.ts - Pipeline routes → Pipeline case records: queries cases
server/src/routes/pipelines.ts - Pipeline services → Pipeline case records: reads and writes
server/src/services/pipelines.ts - Pipeline services → Issue and task service: coordinates issues
server/src/services/pipelines.ts - Pipeline routes → Conversation context: resolves conversation context
server/src/routes/pipelines.ts - Conversation context → Source trust: sanitizes comments
server/src/services/pipeline-conversation-context.ts - Pipeline services → Case outputs: uses case outputs
server/src/services/pipelines.ts - Source trust → Authorization: resolves trust policy
server/src/services/source-trust.ts - Pipeline workspace → Agent adapters: monitors agent work
README.md - Pipeline workspace → Skills and training: manages agent training
README.md - Pipeline workspace → Budgets and costs: tracks costs
README.md - Agent adapters → Application database: records run history
README.md - Authorization → Application database: reads policy data
server/src/services/authorization.ts - Activity history → Application database: persists activity
server/src/services/activity-log.ts