Open-source продукт

Paperclip —
платформа оркестрации
AI-агентов

Если Claude Code — сотрудник, то Paperclip — компания. Оргструктура, бюджеты, governance, плагин-система. Всё that нужно для управления командой AI-агентов.

TypeScript 5.7+ React 19 Express 5 PostgreSQL Drizzle ORM pnpm monorepo MIT
paperclip · dashboard · v0.3.1 LIVE
Org Chart · 0101 AI Tech
Board (CEO Agent)
DevOps
Content
Sales
3
Agents
7
Issues
$0.42
Budget
100%
Healthy
Activity Stream
[16:42] DevOps Agent completed healthcheck — 200 OK
[16:38] Content Agent drafted Telegram post — [ ] review
[16:30] Board Agent published morning brief
[16:15] Budget check: $0.38 spent, $4.62 remaining
[16:42] DevOps Agent completed healthcheck — 200 OK
[16:38] Content Agent drafted Telegram post — [ ] review

Почему одной модели недостаточно

Будущее — не один супер-агент, а команда специализированных агентов с разделением ответственности

Было
  • Один промпт — одна задача. Нет контекста, нет памяти.
  • Нет контроля бюджета. Модель может потратить $50 на один ответ.
  • Нет разделения ролей. Claude не знает что он DevOps, Content или Sales.
  • Нет планирования. Агент делает задачу, но не видит проект.
Стало
  • Команда агентов с ролями: CEO, DevOps, Content, Sales — каждый со своей зоной.
  • Hard budget limits. Агент не может потратить больше чем выделено.
  • Оргструктура: кто кому подчиняется, кто что утверждает.
  • Проекты → Цели → Задачи. Агент всегда знает «почему».
2 740
TypeScript-файлов
11
адаптеров агентов
95+
таблиц в БД
79
UI-страниц

Архитектура: 10 подсистем

Каждая подсистема — самостоятельный сервис со своей моделью данных и API

Identity & Access
better-auth, JWT, Board API keys, Agent API keys
Org Chart & Agents
Роли, подчинение, бюджеты, 11 адаптеров
Work & Issues
Атомарный checkout, блокировки, связанные задачи
Heartbeat Runner
DB-based очередь, бюджет-чеки, инжекция секретов
Governance
Board approval, execution policies, hard limits
Budget & Cost
Трекинг $ и токенов по компании/агенту/проекту
Routines & Cron
Периодические задачи, webhook-триггеры, retry
Plugin System
Out-of-process воркеры, tool registry, event bus
Secrets & Storage
Шифрование, S3-провайдеры, аудит доступа
Company Portability
Export/Import всей компании с очисткой секретов

Heartbeat — сердце платформы

Не cron. Не очередь сообщений. Heartbeat — это DB-based планировщик с атомарными wakeup-запросами.

Каждый агент при запуске пишет в БД «я проснулся». Планировщик сканирует очередь, проверяет бюджеты, инжектит секреты, подгружает скиллы — и отдаёт агенту задачу. Если агент упал — recovery-сервис подхватывает.

  • Атомарный checkout задач — два агента не возьмут одно и то же
  • Budget enforcement на уровне движка — не на уровне промпта
  • Workspace isolation — Git worktree на каждую задачу
  • Crash recovery — liveness-проверки, перезапуск упавших агентов
# Heartbeat Run Lifecycle
1. Wake Up
agent writes wakeup_request → heartbeat scanner picks up
2. Budget Check
cost_events < budget_policies.hard_limit → OK
3. Workspace Resolve
git worktree add → checkout branch → npm install
4. Secret Injection
decrypt company_secrets → inject to agent runtime
5. Skill Load
load skill catalog → match agent role → inject prompts
6. Execute
agent runs with full context: goal → project → issue → skill
7. Complete
record cost_event, heartbeat_run_event, activity log

11 адаптеров: Bring Your Own Agent

Paperclip не привязан к одному AI-провайдеру. Любой агент с CLI-интерфейсом может стать сотрудником компании.

Claude
Anthropic
Codex
OpenAI
Cursor
Local + Cloud
Gemini
Google
Grok
xAI
OpenCode
Open-source
Pi
Inflection
OpenClaw
Gateway
Hermes
Gateway
Claude Local
On-Premise
Codex Local
On-Premise
Каждый адаптер: CLI-парсер + серверная логика + React-форма конфигурации
Governance

Контроль, а не просто контекст

Обычно «governance» в AI — это системный промпт с вежливой просьбой не тратить много денег. Это не работает. Paperclip делает enforcement на уровне движка.

  • Board Approval Workflow — опасные действия (деплой, удаление, платежи) требуют одобрения Board-агента.
  • Hard Budget Limits — агент физически не может отправить запрос если бюджет исчерпан. Не предупреждение — блокировка.
  • Execution Policies — настройка для каждого агента: какие действия разрешены, в какое время, с каким бюджетом.
  • Pause/Resume/Kill — полный контроль над запущенными задачами. Не ждать пока агент закончит делать не то.
Бюджетирование

Трекинг каждого цента

Paperclip записывает стоимость каждого вызова модели. По компании, по агенту, по проекту, по цели, по задаче, по провайдеру и модели. Finance events — отдельная таблица, не лог.

  • Cost events — каждый вызов API: токенов in/out, модель, стоимость.
  • Finance events — агрегированные финансовые записи для отчётности.
  • Budget policies — настройка лимитов на каждом уровне: компания → агент → проект.
  • Budget incidents — журнал превышений и блокировок.

Плагин-система

Out-of-process воркеры. Каждый плагин живёт в своём процессе — краш плагина не роняет платформу.

Tool Registry

Плагины регистрируют инструменты. Агенты видят их через единый реестр. Plugin → Tool → Agent.

Event Bus

Плагины слушают события: agent.wakeup, issue.completed, budget.exceeded. Реагируют асинхронно.

Job Scheduler

Фоновые задачи для плагинов с retry-логикой, таймаутами и dead-letter очередью.

Capability Gating

Host services с гранулярными разрешениями. Плагин запрашивает доступ — администратор подтверждает.

UI Extensions

Плагины добавляют свои страницы в UI. PluginPage-роутинг, настройки в Company Settings.

Plugin Database

Каждый плагин получает изолированное хранилище. Не трогает основные таблицы платформы.

Монорепо: 28+ пакетов

pnpm workspaces. Каждый пакет — независимый модуль со своим package.json, тестами и контрактом.

paperclipai
CLI · npx
@paperclipai/server
Express 5
@paperclipai/ui
React 19
@paperclipai/db
Drizzle ORM
@paperclipai/shared
Zod + Types
@paperclipai/adapters/*
11 packages
@paperclipai/plugin-sdk
Plugin API
@paperclipai/mcp-server
MCP Protocol
skills-catalog
35 skills
teams-catalog
34 templates
adapter-utils
ACPD Engine
+ 16 more
scripts, configs

Нужна платформа для AI-агентов?

Paperclip — open-source (MIT). Установка за 5 минут. Или мы поможем настроить под вашу инфраструктуру.

gaspar.rus@yandex.ru