Paperclip

Beta: Paperclip is in early development. This template and the software may have unexpected issues.

Paperclip is an orchestration platform for coordinating multiple AI agents (Claude, Codex, Cursor, OpenClaw, etc.) to run autonomous businesses. It provides a Node.js server with a React UI that manages agent teams, assigns goals, tracks work, and monitors costs from a central dashboard.

Getting Started

1. Deploy the template and wait for the service to start.
2. Open the Zeabur Terminal for the Paperclip service.
3. Create the first admin account:

   gosu node pnpm paperclipai auth bootstrap-ceo
   

4. Copy the invite URL from the output and open it in your browser to register.
5. Configure AI agent authentication (see AI Agent Authentication below).
6. When creating an agent, set Working directory to a path under /paperclip/ (e.g. /paperclip/workspaces/my-project).
7. Click Test now to run the adapter environment check. A successful result shows hello probe succeeded.
8. After setup, set PAPERCLIP_AUTH_DISABLE_SIGN_UP to true in Zeabur environment variables to prevent unauthorized signups.

AI Agent Authentication

Option 1: Environment variables (recommended)

Set these in Zeabur environment variables:

Tool	Environment Variable
Claude Code	ANTHROPIC_API_KEY
Codex	OPENAI_API_KEY

Option 2: Terminal login

Open the Zeabur Terminal and run:

Tool	Terminal Login
Claude Code	gosu node claude login
Codex	gosu node codex login --device-auth

Notes

• Always use gosu node prefix when running CLI tools in Terminal. The terminal runs as root, but credentials must be stored under the node user's home (/paperclip/) to persist and be accessible by the server.
• Codex device auth: Enable "Enable device code authorization for Codex" in ChatGPT Security Settings before running the login command.

Important Notes

• Persistent storage: Only data under /paperclip/ survives restarts. All other paths are ephemeral.
• Working directory: Do not use /app — it contains the Paperclip source code and will be overwritten on updates. Always use paths under /paperclip/ which is persistent.
• Sign-up control: Set PAPERCLIP_AUTH_DISABLE_SIGN_UP to true after creating your admin account. Temporarily set to false when you need to invite new users, then set back to true.

Changelog

2026-04-22 — v2026.416.0

• Updated image to upstream release v2026.416.0 (ghcr.io/paperclipai/paperclip:sha-b8725c5)
• New: External adapter plugin system with dynamic UI parsers and declarative config schemas
• New: Issue hierarchy display with collapse/expand, sub-task counts, and persisted state
• New: Feedback voting and thumbs-capture flow for evals
• New: Execution workspaces with runtime controls and per-project workspace tab
• New: Workspace-aware routine runs
• Improved: Inbox mail-client keyboard shortcuts and "Today" divider
• Improved: Mobile layouts, dark mode, and adapter override UI
• Security: BETTER_AUTH_SECRET and PAPERCLIP_AGENT_JWT_SECRET are now strictly required at startup (template already sets these)

2026-04-07 — v2026.403.0

• Updated image to upstream release v2026.403.0 (ghcr.io/paperclipai/paperclip:sha-a072377)
• Switched from Docker Hub (zeabur/paperclip) to upstream GitHub Container Registry (ghcr.io/paperclipai/paperclip)
• Changed persistent volume path from /home/node/ to /paperclip/
• Switched CLI command prefix from runuser -u node -- to gosu node
• New: First-class blocker/dependency relations with wake-on-subtasks-done
• Improved: Bearer token redaction in server logs
• Improved: CEO agent onboarding with relative paths
• Improved: Markdown paste auto-formatting in inline editor
• Many bug fixes for UI routing, sidebar, worktree, and agent workflows

2026-03-30 — v2026.325.0

• Updated image to upstream release v2026.325.0 (652 commits since v0.3.1)
• New: Inbox "Mine" tab with archive flow
• New: Hermes adapter support
• New: Cost control plane with billing, quota, and budget management
• New: Plugin SDK with document CRUD and event bus
• New: Worktree support for isolated agent workspaces
• New: Company import/export with org chart SVG
• Improved: Agent detail tabs reorganized (Prompts, Skills, Instructions)
• Improved: Embedded Postgres reliability in Docker
• Many bug fixes for adapters (Codex, Pi, OpenCode, Cursor)

2026-03-16 — Initial Release

• Zeabur template for Paperclip AI agent orchestration platform
• Services: PostgreSQL 17 + Paperclip (prebuilt image zeabur/paperclip, amd64 + arm64)
• Startup script auto-generates config.json on first boot
• Server runs as node user via runuser (required for Claude Code CLI)
• Single persistent volume at /home/node/
• Pre-installed CLI tools: claude-code, codex, opencode-ai

Links

• Documentation
• GitHub