Paperclip — แพลตฟอร์ม Open-Source สำหรับจัดการทีม AI Agent ในองค์กรPaperclip — Open-Source Platform for Managing Teams of AI Agents at Work
Paperclip เป็น Node.js server + React UI แบบ open-source สำหรับ orchestrate ทีม AI agent หลายตัว (Claude Code, Codex, Cursor, Gemini CLI ฯลฯ) ให้ทำงานร่วมกันภายใต้ org chart, budget, governance และ task management เดียวกัน คล้ายระบบ HR/project manager แต่สำหรับ AI agent
Paperclip is an open-source Node.js server and React UI that orchestrates multiple AI agents (Claude Code, Codex, Cursor, Gemini CLI, etc.) under a unified org chart, budget, governance, and task management system — like an HR/project manager for AI agents.
ไว้ทำอะไร
เมื่อองค์กรใช้ AI agent หลายตัวจากหลาย provider พร้อมกัน (เช่น เปิด Claude Code 20 terminal, ใช้ Codex กับ Cursor ควบคู่กัน) จะเกิดปัญหาคือไม่รู้ว่า agent ไหนทำอะไรอยู่ ควบคุมค่าใช้จ่ายไม่ได้ ไม่มีระบบ approve/review งาน และขาดการประสานงานระหว่าง agent Paperclip แก้ปัญหานี้โดยเป็นศูนย์กลางบริหาร AI agent ทั้งหมด — กำหนดเป้าหมาย แบ่งงาน ตั้งงบประมาณ กำหนดสิทธิ์ ติดตามสถานะ และ audit ผลงานจาก dashboard เดียว ใช้ได้ทั้ง self-host และรอ Cloud version
ทำงานอย่างไร
Paperclip เป็น TypeScript monorepo ที่ใช้ pnpm workspace จัดการ package หลักคือ server (Node.js backend), ui (React frontend), cli (command-line tool) และ packages ย่อยอีกหลายตัว ระบบทำงานผ่าน 'heartbeat' โดย agent แต่ละตัวจะรับสัญญาณจาก Paperclip server เพื่อรับงาน ส่งสถานะ และรายงานผล agent สื่อสารกับ server ผ่าน adapter ที่เขียนเฉพาะสำหรับแต่ละ provider
ระบบ adapter รองรับ agent หลากหลาย ได้แก่ Claude Code, OpenClaw, Codex, Cursor (ทั้ง local และ cloud), Gemini CLI, Hermes, Grok, Kimi, OpenCode และ Pi แต่ละ adapter อยู่ใน packages/adapters/ และมี package.json แยกกัน นอกจากนี้ยังรองรับ custom adapter ผ่าน HTTP endpoint หรือ external package
ด้าน data มี packages/db สำหรับจัดการ database พร้อมระบบ migration ส่วน packages/mcp-server ให้บริการ Model Context Protocol เพื่อเชื่อมต่อกับ service ภายนอก เช่น GitHub, Notion, Railway โดยมีระบบ governance กำหนดว่า action ไหน Allowed, Ask first หรือ Off
ระบบ plugin มี SDK อยู่ที่ packages/plugins/sdk ให้นักพัฒนาเขียน plugin เสริมได้ ส่วน Skills catalog และ Teams catalog ให้ทีมแชร์ skill และ template ของทีม agent ได้ทั่วทั้งองค์กร ระบบ E2E testing ใช้ Vitest พร้อม runner acceptance test สำหรับทดสอบ workflow จริงบน Chromium
โครงสร้างโค้ด
- server/ — Node.js backend หลัก รับ heartbeat จาก agent, จัดการ task, org chart, governance
- ui/ — React frontend แสดง dashboard, task board, org chart, cost monitor
- cli/ — CLI tool สำหรับจัดการ Paperclip จาก terminal
- packages/db/ — Database layer พร้อมระบบ migration
- packages/adapters/ — Adapter สำหรับ AI agent แต่ละ provider (Claude, Codex, Cursor, Gemini, Hermes, Grok, Kimi ฯลฯ)
- packages/plugins/sdk/ — Plugin SDK สำหรับเขียน extension เพิ่มเติม
- packages/mcp-server/ — MCP server เชื่อมต่อ service ภายนอก
- packages/paperclip-runner/ — Runner สำหรับ execute agent workflow
- packages/skills-catalog/ — Catalog ของ shared skills ทั่วทั้งองค์กร
- packages/teams-catalog/ — Template ทีม agent สำเร็จรูป
- packages/shared/ — Shared utilities ใช้ร่วมกันทุก package
- tests/runner-e2e/ — E2E test suite ทดสอบ workflow จริงบน Chromium
เริ่มใช้งาน
# Install via npm
npm install -g @paperclipai/cli
# Or clone and run locally
git clone https://github.com/paperclipai/paperclip.git
cd paperclip
pnpm install
pnpm build
# Start development server (backend + frontend)
pnpm dev:both
# Or run with Docker
docker build -t paperclip .
docker run -p 3000:3000 paperclipเหมาะกับงานแบบไหน
- บริหารทีม AI agent หลายตัวจากหลาย provider (Claude, Codex, Cursor, Gemini) จาก dashboard เดียว
- ตั้ง org chart สำหรับ AI agent — กำหนดหัวหน้า ลูกน้อง role และ responsibility
- ควบคุมค่าใช้จ่าย AI ด้วยระบบ budget ระดับบริษัท, agent และ project
- สร้าง workflow อัตโนมัติที่ agent ทำงานต่อเนื่อง 24/7 พร้อมระบบ approve/review
- ตั้ง routine งานแบบ scheduled ให้ agent ทำซ้ำอัตโนมัติ เช่น daily report, code review
- แชร์ skill และ team template ทั่วทั้งองค์กรผ่าน Skill Studio
- เชื่อมต่อ MCP server กับ service ภายนอก (GitHub, Notion, Railway) พร้อม governance control
- ติดตามและ audit งานของ agent จากมือถือ
ข้อควรรู้
- License MIT — ใช้ได้ทั้ง commercial และ personal
- ต้อง self-host เอง (Node.js + database) ส่วน Cloud version ยังอยู่ในขั้น waitlist
- ต้องมี API key ของ AI provider แต่ละตัวที่ต้องการใช้ (Claude, OpenAI, etc.)
- ระบบค่อนข้างซับซ้อน มีหลาย package และ adapter — ต้องเข้าใจ architecture ก่อน customize
- บาง feature ยังเป็น experimental เช่น Agent Chat และ chat/email connectors (Slack, Discord, Telegram)
- ใช้ pnpm workspace ต้องติดตั้ง pnpm และ Node.js version ตามที่กำหนดใน .nvmrc
- ระบบ E2E eval บาง test ต้องใช้ credential จริงและมีค่าใช้จ่าย (paid provider calls)
What it is for
When organizations run many AI agents from different providers simultaneously (e.g., 20 Claude Code terminals plus Codex and Cursor), they lose track of what each agent is doing, cannot control costs, lack approval/review workflows, and have no coordination between agents. Paperclip solves this by serving as a central management hub for all AI agents — define goals, assign tasks, set budgets, configure permissions, monitor status, and audit output from a single dashboard. It can be self-hosted, with a Cloud version on the waitlist.
How it works
Paperclip is a TypeScript monorepo managed with pnpm workspaces. The main packages are server (Node.js backend), ui (React frontend), cli (command-line tool), and numerous sub-packages. The system operates via 'heartbeats' — each agent receives signals from the Paperclip server to pick up tasks, report status, and return results. Agents communicate through provider-specific adapters.
The adapter system supports Claude Code, OpenClaw, Codex, Cursor (local and cloud), Gemini CLI, Hermes (+Gateway), Grok, Kimi, OpenCode, and Pi. Each adapter lives in packages/adapters/ with its own package.json. Custom adapters can be added via HTTP endpoints or external packages.
Data management uses packages/db with a migration system. packages/mcp-server provides Model Context Protocol support for connecting external services like GitHub, Notion, and Railway, with governance controls (Allowed, Ask first, or Off) per action.
The plugin system provides an SDK at packages/plugins/sdk for building extensions. Skills Catalog and Teams Catalog let organizations share agent skills and pre-configured team templates. E2E testing uses Vitest with runner acceptance tests that exercise real workflows on Chromium.
Code structure
- server/ — Main Node.js backend handling heartbeats, tasks, org chart, and governance
- ui/ — React frontend for dashboard, task board, org chart, and cost monitoring
- cli/ — Command-line tool for managing Paperclip from the terminal
- packages/db/ — Database layer with migration system
- packages/adapters/ — Provider-specific adapters (Claude, Codex, Cursor, Gemini, Hermes, Grok, Kimi, etc.)
- packages/plugins/sdk/ — Plugin SDK for building extensions
- packages/mcp-server/ — MCP server for external service connections
- packages/paperclip-runner/ — Runner for executing agent workflows
- packages/skills-catalog/ — Organization-wide shared skills catalog
- packages/teams-catalog/ — Pre-built agent team templates
- packages/shared/ — Shared utilities across all packages
- tests/runner-e2e/ — E2E test suite running real workflows on Chromium
Getting started
# Install via npm
npm install -g @paperclipai/cli
# Or clone and run locally
git clone https://github.com/paperclipai/paperclip.git
cd paperclip
pnpm install
pnpm build
# Start development server (backend + frontend)
pnpm dev:both
# Or run with Docker
docker build -t paperclip .
docker run -p 3000:3000 paperclipGood fit for
- Manage multiple AI agents from different providers (Claude, Codex, Cursor, Gemini) via a single dashboard
- Build an org chart for AI agents — define managers, reports, roles, and responsibilities
- Control AI costs with budgets at company, agent, and project levels
- Create autonomous workflows where agents work 24/7 with approval and review gates
- Set up scheduled routines for recurring agent tasks like daily reports or code reviews
- Share skills and team templates across the organization via Skill Studio
- Connect MCP servers to external services (GitHub, Notion, Railway) with governance controls
- Monitor and audit agent work from mobile devices
Things to know
- MIT license — free for commercial and personal use
- Self-hosted only (Node.js + database); Cloud version is still on waitlist
- Requires API keys from each AI provider you want to use (Claude, OpenAI, etc.)
- Complex architecture with many packages and adapters — understanding the structure is needed before customization
- Some features are experimental, including Agent Chat and chat/email connectors (Slack, Discord, Telegram)
- Uses pnpm workspaces; requires pnpm and the Node.js version specified in .nvmrc
- Some E2E eval tests require real credentials and incur provider costs
บทวิเคราะห์นี้สร้างจาก README และโค้ดของ repo โดย AI ของ Oneable — ตรวจสอบ license และเอกสารต้นทางก่อนนำไปใช้งานจริงThis breakdown was generated from the repository's README and code by Oneable's AI — check the license and upstream docs before using it in production.