ONEDEV

paperclip

AI Agent OrchestrationCLITypeScript

★ 80,575주당 +5,499조회 15

무엇인가

Paperclip은 AI 에이전트 팀을 조직 단위로 운영하기 위한 제어 평면(control plane)이다. 에이전트의 추론 루프를 만들지 않고 코드도 생성하지 않는다. OpenClaw, Claude Code, Codex, Cursor, bash, HTTP 같은 실행 런타임 위에 놓여 목표 배분, 조직도, 예산, 승인 절차를 담당한다. 화면은 작업 관리자 형태지만 내부 구조는 조직도, 예산, 거버넌스, 목표 정렬, 에이전트 조정으로 이루어진다.

어떻게 동작하나

중심은 하트비트 실행이다. DB 기반 wakeup 큐에 깨어날 에이전트를 넣고 병합(coalescing)한 뒤, 예산 검사, 워크스페이스 해석, 시크릿 주입, 스킬 로딩, 어댑터 호출 순으로 진행한다. 각 실행은 구조화 로그, 비용 이벤트, 세션 상태, 감사 기록을 남기고 고아 실행은 자동 복구된다. 작업은 이슈 단위로 회사·프로젝트·목표·부모에 연결되며, 원자적 체크아웃과 실행 잠금이 중복 작업을 막는다. 블로커 의존성, 댓글, 문서, 첨부, 작업 산출물, 라벨, 인박스 상태가 이슈에 붙는다. 워크스페이스는 프로젝트 워크스페이스와 격리 실행 워크스페이스(git worktree, 운영자 브랜치)로 나뉘고 dev 서버·프리뷰 URL 같은 런타임 서비스가 여기에 연결된다. 인증은 신뢰 로컬 모드와 인증 모드 두 가지이며 보드 사용자, 에이전트 API 키, 단명 run JWT, 회사 멤버십, 초대 흐름으로 구성된다. 모든 변경 요청은 행위자에 추적된다.

무엇과 다른가

에이전트 프레임워크가 에이전트 자체를 만드는 도구라면 Paperclip은 그 위의 운영 계층이다. 여러 터미널을 띄워 각 에이전트를 눈으로 감시하는 방식과 달리, 조직도·보고 라인·권한·예산이 데이터로 존재하고 하트비트가 위아래로 위임을 흘려보낸다. 비용은 회사·에이전트·프로젝트·목표·이슈·제공자·모델 단위로 집계되고, 범위별 예산 정책에 경고 임계값과 하드 스톱이 걸린다. 한도를 넘으면 에이전트가 일시정지되고 대기 중인 작업이 취소된다. 거버넌스는 채용 승인, 전략 덮어쓰기, 일시정지·종료를 포함한다.

어떻게 쓰나

배포 형태는 Node.js 서버와 React UI다. 에이전트는 어댑터로 등록한다. Claude Code, Codex, Cursor·Gemini·bash 같은 CLI 에이전트, OpenClaw 같은 HTTP·웹훅 봇, 외부 어댑터 플러그인이 그 예이며 하트비트를 받을 수 있으면 등록 대상이 된다. 반복 작업은 cron, 웹훅, API 트리거로 루틴을 만들고 실행마다 추적되는 이슈가 생성되며 담당 에이전트가 깨어난다. 플러그인은 인스턴스 전역으로 붙고 프로세스 외부 워커, 능력 게이트가 걸린 호스트 서비스, 작업 스케줄링, 도구 노출, UI 기여를 사용한다. 회사 전체는 에이전트·스킬·프로젝트·루틴·이슈를 내보내고 가져올 수 있고 시크릿은 스크러빙된다.

전제와 한계

하나의 배포로 여러 조직을 운영하며 데이터는 완전히 격리된다. 시크릿은 인스턴스와 회사 단위로 암호화 로컬 저장 또는 제공자 기반 객체 저장에 보관되고, 범위가 지정된 실행이 명시적으로 필요로 할 때만 프롬프트에 들어간다. 에이전트는 하트비트를 수신할 수 있어야 하며 그렇지 않은 런타임은 어댑터를 따로 작성해야 한다. 서버와 UI를 실행할 Node.js 환경이 전제다.

유사 도구