‏Paperclip؛ ایجنت‌هات رو مثل یه شرکت اداره کن

تو معرفی پروژه اومده که Paperclip یه سرور Node.js با رابط React‌ه که به‌جای یه ایجنت، یه تیم از ایجنت‌های AI رو می‌چرخونه. تشبیهی که خود تیم می‌کنه اینه: اگه OpenClaw یه کارمنده، Paperclip خود شرکته. ظاهرش شبیه یه تسک‌منیجر معمولیه، ولی زیر پوستش چارت سازمانی، بودجه، قوانین تأیید و هم‌راستا کردن ایجنت‌ها با هدف شرکت نشسته. سه قدم داره: هدف رو تعریف می‌کنی، تیم رو استخدام می‌کنی و بعد از تأیید استراتژی و تعیین بودجه، اجرا رو از داشبورد تماشا می‌کنی.

موتور اصلیش چیزیه که بهش می‌گن heartbeat (یعنی ایجنت طبق یه زمان‌بندی بیدار می‌شه، کاراش رو چک می‌کنه و یه قدم جلو می‌ره). هر چیزی که بتونه همین سیگنال رو بگیره استخدام می‌شه: Claude Code، Codex، Cursor، اسکریپت bash یا یه بات HTTP. کارها به‌شکل تیکت تعریف می‌شن، برداشتن هر تیکت اتمیک انجام می‌شه تا دو ایجنت هم‌زمان سراغ یه کار نرن، و وضعیت session بین heartbeatها حفظ می‌شه؛ یعنی ایجنت بعد از هر بار بیدار شدن از صفر شروع نمی‌کنه.

نکتهٔ دومی که تیم پروژه روش تأکید داره کنترل هزینه‌ست. مصرف توکن و هزینه به تفکیک شرکت، ایجنت، پروژه، هدف، تیکت، provider و مدل ثبت می‌شه و می‌تونی بودجهٔ ماهانه با آستانهٔ هشدار و سقف قطعی بذاری؛ وقتی سقف رد شد، ایجنت pause می‌شه و کارهای تو صف کنسل می‌شن. کنار این، مرحلهٔ تأیید انسانی هم هست: استخدام ایجنت جدید، تغییر استراتژی یا pause و terminate کردن هر ایجنت دست خودته و تغییرهای config نسخه‌بندی می‌شن که بشه برشون گردوند.

تیم پروژه صریح می‌گه Paperclip چت‌بات، فریم‌ورک ساخت ایجنت یا ابزار ساخت workflow با drag-and-drop نیست و قرار نیست بهت بگه ایجنتت رو چطور بنویسی؛ فقط سازمانی که توش کار می‌کنن رو اداره می‌کنه. به گفتهٔ خودشون اگه فقط یه ایجنت داری احتمالاً بهش نیاز نداری، ولی اگه بیست تا داری قطعاً داری. مدیریت pull request و code review هم جزو کارش نیست و باید فرایند بازبینی خودت رو بیاری.

راه‌اندازیش self-hosted‌ه و حساب کاربری Paperclip نمی‌خواد: یه دستور onboard از npx کافیه و پیش‌فرض روی حالت local loopback بالا میاد؛ برای حالت احراز هویت‌شده باید bind رو صریح روی lan یا tailnet بذاری. سرور API روی پورت 3100 بالا میاد و یه Postgres توکار خودش ساخته می‌شه، پس نصب جدا لازم نیست. پیش‌نیازش Node.js نسخهٔ 20 به بالا و pnpm نسخهٔ 9.15 به بالاست.

نکات کلیدی:

• هر ایجنت با heartbeat بیدار می‌شه و برداشتن تیکت اتمیکه، پس دو ایجنت هم‌زمان سراغ یه کار نمی‌رن.
• بودجه به تفکیک شرکت، ایجنت، پروژه، هدف، provider و مدل ردیابی می‌شه؛ رد شدن از سقف یعنی pause خودکار و کنسل شدن صف کار.
• یه deployment می‌تونه چند شرکت رو با جداسازی کامل داده اجرا کنه و کل سازمان با پاک‌سازی secretها export و import می‌شه.
• پیش‌نیاز اجرا: Node.js 20+ و pnpm 9.15+؛ سرور API روی پورت 3100 با یه Postgres توکار بالا میاد.
• telemetry پیش‌فرض روشنه و با متغیر محیطی PAPERCLIP_TELEMETRY_DISABLED=1 یا DO_NOT_TRACK=1 خاموش می‌شه و تو CI خودکار غیرفعاله.
• کد پروژه با لایسنس MIT منتشر شده و سیستم پلاگین برای اضافه کردن قابلیت بدون fork کردن داره.