Self-hosted multi-agent orchestration and governance control plane · Active and feature-rich, but several surfaces are explicitly experimental or early and overall production maturity is uncertain from the supplied files.

paperclipai/paperclip

MIT-licensed, self-hosted Node.js and React control plane that orchestrates Claude Code and other agents through tasks, goals, org charts, heartbeats, budgets, approvals, skills, governed connections, plugins, workspaces, and audit history; it runs alongside Claude Code as a standalone host/orchestrator and exposes Paperclip operations through MCP.

AI agent orchestrationClaude Code operationsTask and project managementGovernance and approvalsCost managementAgent skills and evaluationMCP and integrationsPlugin developmentSandboxed executionObservability
Routing score
80.0
Readiness
Usable for self-hosted local and authenticated deployments; production operation requires security, credential, storage, database, runtime, and network planning.
License
MIT
Maintenance
active
Components
20
Revision
0

Selection

Select when

  • You coordinate many simultaneous Claude Code or mixed-agent sessions.
  • You need persistent task context and resumable adapter sessions.
  • You need organization, role, reporting-line, and goal models for agents.
  • You need cost attribution, budget warnings, and hard stops.
  • You require human approvals or review stages before agent work proceeds.
  • You want recurring agent work triggered by schedules, APIs, or webhooks.
  • You need governed MCP or application connections with auditable action policies.
  • You want a self-hosted dashboard spanning coding and non-coding work.
  • You need multiple organizations isolated within one deployment.
  • You plan to extend the control plane through trusted plugins.

Boundaries

Avoid when

  • You only use one agent occasionally and do not need orchestration.
  • You want a small Claude Code skill, hook, or configuration-only extension.
  • You cannot operate a persistent Node.js service and database-backed application.
  • You require a mature sandbox for untrusted third-party plugin code.
  • You require telemetry to be disabled without configuration.
  • You cannot review credential, network, storage, and authentication settings.
  • You need guaranteed real-time budget enforcement before delayed usage is recorded.
  • You need a finished desktop application rather than a web UI.
  • You require every advertised surface to be non-experimental.
  • You need proven compatibility with a Claude Code version not covered by supplied evidence.

Strengths

Capabilities

Orchestrates Claude Code, Codex, Cursor, Gemini CLI, OpenCode, Pi, Hermes, Kimi Code, Grok Build, HTTP bots, and custom processes through adapters.Models multiple organizations with company-scoped tasks, agents, permissions, activity, and histories in one deployment.Links issues and projects to goals so runtime context can include the work's organizational purpose.Uses heartbeats and a database-backed wakeup queue to invoke agents for assignments, follow-ups, schedules, APIs, or webhooks.Provides atomic task checkout and execution locks to reduce competing work on the same issue.Persists task threads, comments, documents, attachments, work products, run logs, usage, and adapter session state.Tracks token and cost data across companies, agents, projects, goals, issues, providers, and models.Supports budget thresholds, hard stops, alerts, and automatic pauses based on recorded spend.Provides approval workflows, review stages, decision tracking, and pause, resume, reassignment, or termination controls.Supports project repositories, Git worktrees, operator branches, runtime services, previews, and configurable sandbox providers.Injects Paperclip workflow skills and project context into agents at runtime.Provides Skill Studio, shared skills, saved test inputs, evaluation runs, version history, and restoration.Exposes Paperclip task, document, approval, workspace, agent, and connection operations through a REST-backed MCP server.Governs external connections through profiles, allow, ask-first, or block policies, credential brokering, and audit events.Supports recurring routines with cron, webhook, and API triggers plus concurrency and catch-up policies.Provides an out-of-process plugin system with capability-gated host services, tools, jobs, webhooks, API routes, events, and React UI contributions.Offers company export and import with optional projects, routines, tasks, attachments, collision handling, and secret-value omission.Supports trusted-local loopback mode and authenticated deployments for LAN, private-network, or persistent server access.Ships non-root agent runtime container definitions for Claude Code and several other coding harnesses, with ephemeral per-run credential injection.Includes prompt evaluations, deterministic tests, browser E2E campaigns, provider-backed runner matrices, and retained evidence workflows.

Risk profile

Risks and limitations

  • Uncertainty: only selected first-party files were supplied, so adapter internals, authorization enforcement, migrations, backup behavior, installers, and most runtime code were not directly inspected.
  • Uncertainty: repository metadata and many supplied plans or tests are dated in 2026, so release chronology and current stability cannot be independently reconciled here.
  • Uncertainty: no supplied Claude Code version matrix establishes compatibility across Claude Code releases.
  • Uncertainty: first-party claims about scale, merged pull requests, isolation, recovery, and feature completeness were not independently reproduced.
  • Several surfaces are explicitly experimental, including Agent Chat and chat or email connectors, while memory, cloud deployment, and a desktop app remain incomplete or planned.
  • Budget enforcement uses recorded spend, so reporting delay and in-flight work can postpone a hard stop.
  • Telemetry is enabled by default, although documented configuration can disable it.
  • Plugin workers and same-origin plugin UI are trusted code; capability declarations are not a sandbox boundary for untrusted plugins.
  • Dynamic plugin installation is currently best suited to single-node persistent deployments and needs writable storage, npm, and registry access.
  • Company exports omit referenced secrets but may retain plain environment values and local paths, so packages require review before sharing.
  • Self-hosting requires careful management of credentials, network exposure, storage, backups, upgrades, and optional third-party services.
  • No independent security audit, privacy assessment, sandbox escape analysis, or comprehensive production benchmark was supplied.

Documented controls include trusted-local or authenticated modes, human permissions, company-scoped access, agent API keys, short-lived run JWTs, encrypted credential storage, secret references, action policies, approvals, audit history, non-root runtime images, ephemeral run credentials, and signed container images. Important caveats are that plugin workers and same-origin plugin UI are trusted rather than sandboxed, broad escape-hatch MCP API access exists within authenticated `/api` scope, sandbox strength depends on the configured provider, and safe remote deployment requires explicit authentication and network design.

Component inventory

20 documented components

standalone application / orchestration service

Paperclip control plane

Node.js server and React board for coordinating multi-agent organizations with tasks, goals, org charts, budgets, governance, history, and costs. Relative to Claude Code, it is an external orchestration/control plane that runs Claude Code as an agent rather than a native Claude Code extension.

README.md
web interface

Paperclip Board UI

Task-manager-style dashboard for agents, tasks, approvals, goals, costs, artifacts, connections, skills, routines, and organization management.

README.md
CLI command

paperclipai onboard

Guided instance setup; preserves existing configuration when rerun and supports loopback, LAN, or tailnet binding.

README.md
CLI command

paperclipai test-drive

Runs an isolated foreground test instance initialized with a CEO agent; supports Codex or OpenCode harness selection, retained data directories, and optional browser opening.

README.md
CLI workflow

Company portability commands

Exports organizations and previews or imports portable company packages; packages can include agents, skills, projects, routines, tasks, and attachments with documented secret omissions.

cli/README.md
agent adapter / orchestration integration

Claude Code agent integration

Paperclip can hire and invoke Claude Code as an agent, assign ticketed work, preserve supported sessions, inject runtime skills and project context, and track runs and spend. This is orchestration around Claude Code, not a Claude plugin or hook.

README.md
runtime workflow

Heartbeat execution

DB-backed agent wakeup pipeline with task checkout, budget checks, workspace resolution, secrets, skills, adapter invocation, logs, usage, and recovery.

README.md
workflow service

Scheduled Routines

Creates recurring tracked tasks with an owner and run history using cron, webhook, or API triggers plus concurrency and catch-up policies.

README.md
skill management module

Skills and Skill Studio

Installs or authors shared organizational skills, injects them into agent runs, tests them with saved inputs, tracks quality, and supports version restore.

README.md
governed tool service

Apps, Connections, and MCP Tool Gateway

Connects services or remote MCP servers, catalogs actions, brokers credentials, applies Allowed/Ask first/Off policies, and records audited calls without giving agents durable provider credentials.

doc/connections/README.md
MCP server / tool surface

Paperclip MCP Server

Thin stdio MCP wrapper over the Paperclip REST API exposing documented read, write, approval, document, workspace, connection, and escape-hatch tools.

packages/mcp-server/README.md
plugin system

Paperclip plugin runtime

Instance-wide, out-of-process plugin workers can subscribe to events, schedule jobs, expose tools and API routes, invoke agents, receive webhooks, keep state, and contribute UI.

README.md
TypeScript SDK

@paperclipai/plugin-sdk

Official SDK for plugin workers, React UI extensions, tests, bundling, protocol types, and development serving.

packages/plugins/sdk/README.md
development service / CLI

paperclip-plugin-dev-server

Serves plugin UI assets and emits SSE reload events for local plugin development.

packages/plugins/sdk/README.md
UI extension surface

Plugin UI slots and launchers

Lets plugins add pages, sidebars, settings, dashboard widgets, entity tabs, toolbar actions, comment extensions, overlays, and project links.

packages/plugins/sdk/README.md
container runtime infrastructure

Agent runtime image family

Sandbox-oriented images for OpenCode, Pi, Codex, Gemini CLI, and Claude Code, using a non-root agent shim and per-run mounted commands and credentials.

docker/agent-runtime/README.md
conversation workflow

Experimental Agent Chat

Adds persistent conversations with agents in Paperclip and optional chat/email connectors for Slack, Discord, Telegram, and AgentMail.

README.md
team template workflow

Ready-Made Teams

Previews and installs teams containing roles, skills, projects, and routines, with operator-selected runtimes.

README.md
published UI module

@paperclipai/ui

npm package containing the production Paperclip board static assets under dist; Storybook supports component development.

ui/README.md

Technical profile

Requirements and configuration

License
MIT according to GitHub metadata and the supplied README.
Language
TypeScript is the repository's primary GitHub language.
Architecture
Standalone Node.js server and React web UI acting as a control plane over adapter-invoked agent runtimes.
Database
Embedded PostgreSQL is created for local setup, while production can use an operator-managed PostgreSQL instance.
Storage
Local file storage is supported, with S3-compatible storage described for attachments and work products.
ClaudeRelationship
Paperclip hosts and orchestrates Claude Code as an agent runtime, injects runtime skills and task context, and offers a Paperclip MCP server to Claude-compatible clients.
AgentExecution
A database-backed wakeup queue performs budget checks, workspace resolution, secret injection, skill loading, adapter invocation, and run recording.
Mcp
The @paperclipai/mcp-server package wraps the REST API and exposes read, write, approval, document, workspace, and run-scoped connection tools.
Plugins
Out-of-process TypeScript workers use JSON-RPC-style host services, while plugin React bundles contribute same-origin UI slots and launchers.
Deployment
Documented modes include local loopback, authenticated LAN or tailnet access, persistent servers, Docker, and configurable sandbox providers.
RuntimeImages
Ubuntu 22.04, Node 24, non-root container images are defined for Claude Code, Codex, Gemini CLI, OpenCode, and Pi.
Observability
Server tracing can use opt-in OpenTelemetry, and server or browser errors can use opt-in Sentry.
Testing
The repository documents Vitest, Playwright, Promptfoo behavior evals, deterministic server checks, and isolated paid runner E2E campaigns.
Telemetry
Anonymous usage telemetry is enabled by default and can be disabled by configuration or documented environment conventions.
UiPackage
The published @paperclipai/ui package contains production static assets rather than the UI source tree.
SourceDevelopment
The supplied development requirements are Node.js 24.11+, pnpm 9.15+, and optionally Rust for native runner builds.

Classification

How it enters the stack

OrchestrationContext InjectionTool Surface

Evidence: Paperclip runs as a standalone server/UI that invokes Claude Code through adapters, injects skills and work context at runtime, and exposes Paperclip operations through MCP. Setup is high for production because it spans service, database, credentials, runtimes, storage, authentication, and optional sandboxes.

Standalone · high setup effort · high confidence · automated

Evidence and risk

Primary sources

first_party_fileREADME.mdhttps://github.com/paperclipai/paperclip/blob/master/README.md
first_party_fileui/README.mdhttps://github.com/paperclipai/paperclip/blob/master/ui/README.md
first_party_filecli/README.mdhttps://github.com/paperclipai/paperclip/blob/master/cli/README.md
first_party_fileevals/README.mdhttps://github.com/paperclipai/paperclip/blob/master/evals/README.md

Routing context

Conflicts, complements, and synergies

integrates_with

gh_nousresearch_hermes_agent

The Paperclip README explicitly lists Hermes and Hermes Gateway among supported agent runtimes, while Hermes is cataloged as a standalone agent platform.

high confidence
overlaps_with

gh_amelnagdy_delegate_skills

Inference: both coordinate Claude Code with other coding-agent CLIs, but Paperclip is a persistent organization control plane whereas delegate-skills is a Claude-oriented delegation skill package.

medium confidence
complementary_to

gh_apache_maka

Inference: Maka could conceptually operate alongside an external control plane, but no supplied first-party file documents direct Paperclip integration.

low confidence