이게 불편했어요

Claude Code 탭을 스무 개쯤 열어 두면 어느 탭이 무슨 일을 하는지 금방 놓쳐요. 재부팅하면 그 맥락이 다 날아가서, 에이전트에게 지금 무엇을 왜 하던 중인지 여기저기서 모아 다시 설명해야 했어요. 밤새 같은 일을 되풀이한 루프가 토큰을 다 써 버린 걸 다음 날에야 알게 되기도 하고요.

그래서 이렇게 풀어요

Paperclip은 에이전트마다 직함과 상사, 예산이 붙은 조직도를 만들고, 일은 티켓으로 맡겨요. 티켓에는 프로젝트와 회사 목표가 따라붙어서 에이전트가 무엇을 하는지뿐 아니라 왜 하는지까지 받아 가요. 에이전트는 계속 돌지 않고, 일이 배정되거나 댓글이 달리거나 정해 둔 시간이 될 때만 깨어나 한 번 일하고 잠들어요. 예산 한도에 닿으면 그 일은 멈춰요.

안에서는 이렇게 돌아가요

1. 1

   나 (보드) → Paperclip 서버

   에이전트에게 티켓 배정배정되면 서버가 담당 에이전트를 깨우는 요청을 큐에 넣어요. backlog 상태인 티켓은 깨우지 않아요.server/src/services/issue-assignment-wakeup.ts
2. 2

   루틴 (cron, 웹훅) → Paperclip 서버

   정해진 때마다 티켓 생성루틴이 돌 때마다 담당자가 붙은 티켓을 만들고, 같은 깨우기 경로로 에이전트를 불러요.server/src/services/routines.ts
3. 3

   Paperclip 서버 → Claude Code

   claude --print --output-format stream-jsonClaude 어댑터가 Claude Code를 띄우고 실행용 단기 토큰을 PAPERCLIP_API_KEY로 넣어요. 저장된 세션이 있으면 --resume으로 이어 가요.packages/adapters/claude-local/src/server/execute.ts
4. 4

   paperclip 스킬 → Claude Code

   하트비트 절차깨어나면 받은 일 확인, 체크아웃, 작업, 보고 순서로 한 번 일하고 끝내요. 계속 돌지 않아요.skills/paperclip/SKILL.md
5. 5

   Claude Code → Paperclip 서버

   POST /api/issues/{issueId}/checkout한 티켓은 한 에이전트만 잡아요. 다른 에이전트가 쥐고 있으면 409를 받고 다른 일로 넘어가요.server/src/services/issues.ts
6. 6

   Paperclip 서버 → Claude Code

   예산 한도에 닿으면 실행 중지회사, 에이전트, 프로젝트 단위 예산을 넘으면 해당 실행에 중지 요청을 남겨 멈춰요.server/src/services/heartbeat/budget-cancellation.ts
7. 7

   Claude Code → 티켓 댓글과 문서

   PUT /api/issues/{issueId}/documents/{key}결과는 티켓의 문서와 댓글로 남고, 실행 로그와 사용량 기록도 함께 쌓여요.skills/paperclip/SKILL.md

나한테 맞을까요

What was hard

With twenty Claude Code tabs open, you soon lose track of which one is doing what. A reboot wipes that context, and you end up gathering it from several places to remind each agent what it was doing and why. Sometimes you only learn the next morning that a loop spent the night burning tokens.

What it does about it

Paperclip gives each agent a title, a manager and a budget on an org chart, and hands out work as tickets. Each ticket carries its project and company goal, so the agent gets the why along with the what. Agents don't run all the time: they wake when work is assigned, a comment arrives or a schedule fires, do one round of work and stop. When a budget hits its limit, that work pauses.

How it runs inside

1. 1

   You (the board) → Paperclip server

   Assign a ticket to an agentAssignment queues a wakeup for the assignee; tickets in backlog wake nobody.server/src/services/issue-assignment-wakeup.ts
2. 2

   Routine (cron, webhook) → Paperclip server

   Create a ticket on scheduleEach routine run creates an assigned ticket and wakes the agent through the same path.server/src/services/routines.ts
3. 3

   Paperclip server → Claude Code

   claude --print --output-format stream-jsonStarts Claude Code with a short-lived run token in PAPERCLIP_API_KEY, resuming a saved session.packages/adapters/claude-local/src/server/execute.ts
4. 4

   paperclip skill → Claude Code

   The heartbeat procedureOn waking: check assignments, check out, work, report, exit. It never runs continuously.skills/paperclip/SKILL.md
5. 5

   Claude Code → Paperclip server

   POST /api/issues/{issueId}/checkoutOne ticket, one agent: if another agent holds it, the call returns 409 and the agent moves on.server/src/services/issues.ts
6. 6

   Paperclip server → Claude Code

   Stop the run at the budget limitPast a company, agent or project budget, the server records a stop request on the run and halts it.server/src/services/heartbeat/budget-cancellation.ts
7. 7

   Claude Code → Ticket comments and documents

   PUT /api/issues/{issueId}/documents/{key}Results stay on the ticket as documents and comments, with run logs and usage records alongside.skills/paperclip/SKILL.md

Is it for you