Paperclip: AI 에이전트 여러 개에 예산과 작업 잠금을 거는 오픈소스 관리 앱

Paperclip의 README는 "Build the #1 AI note-taking app to $1M MRR" 같은 목표를 적고, CEO, CTO, 엔지니어, 마케터 에이전트를 고용해 회사를 굴리라고 말합니다. 2026년 3월에 리포가 만들어졌고, 9월 말 기준 GitHub 스타가 9만 4천 개를 넘었고 9월 하순 GitHub 트렌딩 상위권에 올랐습니다. MIT 라이선스이고 셀프호스팅이며 계정이 필요 없습니다.

솔직히 첫 문단만 읽으면 과장 광고처럼 들립니다. 그런데 README의 나머지를 읽으면 이 도구가 실제로 해결하는 문제는 훨씬 수수하고, 그래서 더 쓸모 있습니다. 이 글은 README와 저장소 문서를 근거로 씁니다.

에이전트로 회사를 차린다는 말의 실제 내용

"AI 에이전트 회사"라는 표현은 에이전트가 알아서 사업을 굴린다는 뜻으로 읽힙니다. README가 스스로 적어 둔 해결 과제 표를 보면 이야기가 다릅니다.

첫 줄은 Claude Code 탭을 스무 개 열어 두고 어느 탭이 무슨 일을 하는지 모르며, 재부팅하면 전부 잃는다는 문제입니다. 다음은 폭주한 루프가 수백 달러어치 토큰을 쓰고 사용량 한도를 다 채울 때까지 아무도 모른다는 문제입니다. 고객 지원이나 보고서처럼 반복되는 일을 사람이 기억해서 매번 시작시켜야 한다는 문제도 있습니다.

전부 에이전트를 여러 개 오래 돌리는 사람이 이미 겪고 있는 운영 문제입니다. 회사라는 비유는 이 운영 기능들을 묶는 포장이고, 알맹이는 작업 관리, 예산, 감사 기록입니다. 저는 Paperclip을 볼 때 이 알맹이 쪽을 기준으로 판단하는 편이 맞다고 봅니다.

같은 일을 두 번 하지 않게 하는 작업 잠금

README의 "왜 특별한가" 표 첫 줄은 원자적 실행입니다. 작업을 가져가는 일(checkout)과 예산 차감이 원자적으로 처리되어, 두 에이전트가 같은 작업을 동시에 집어 가거나 예산을 넘겨 쓰는 일이 없다는 것입니다.

지루해 보이지만 에이전트를 여럿 돌리면 가장 먼저 터지는 문제가 이것입니다. 작업 목록을 공유 파일이나 칸반 보드로 관리하면 두 에이전트가 같은 이슈를 동시에 시작합니다. 사람 팀이라면 "제가 할게요" 한마디로 풀리는 일을 에이전트끼리는 잠금으로 풀어야 합니다. README의 FAQ도 Asana나 Trello에 에이전트를 연결하면 되지 않느냐는 질문에, 누가 무엇을 가져갔는지와 세션 유지와 비용 감시 같은 미묘한 조율이 필요하다고 답합니다.

에이전트마다 월 예산과 정지선

두 번째 알맹이는 비용입니다. 에이전트마다 월 예산을 두고, 한도에 닿으면 에이전트가 멈춥니다. 비용은 회사, 에이전트, 프로젝트, 목표, 이슈, 제공자, 모델 단위로 집계되고, 경고선과 정지선을 따로 둘 수 있습니다. 예산을 넘기면 에이전트가 일시 정지되고 대기 중인 작업이 취소됩니다.

에이전트를 사람이 보지 않는 시간에 돌리는 순간 이 기능은 선택이 아니게 됩니다. 사람이 화면 앞에 있으면 이상한 반복을 보고 멈출 수 있지만, 새벽 세 시에 도는 루프를 멈추는 것은 미리 정한 숫자뿐입니다. 저라면 Paperclip을 쓰지 않더라도 에이전트를 무인으로 돌리는 곳에는 반드시 이런 정지선부터 두겠습니다.

정해진 시간에 깨어나는 heartbeat

Paperclip의 에이전트는 기본적으로 계속 돌지 않습니다. 정해진 주기(heartbeat)나 작업 배정, 멘션 같은 사건이 있을 때 깨어나서 할 일을 확인하고 일합니다. 깨어날 때마다 예산 확인, 작업 폴더 지정, 필요한 비밀값 주입, 스킬 로드를 거쳐 에이전트를 부르고, 실행마다 로그와 비용과 세션 상태를 남깁니다. 같은 작업을 이어서 할 때는 처음부터 다시 시작하지 않고 이전 맥락에서 재개합니다.

README의 문구대로 heartbeat를 받을 수 있으면 무엇이든 고용됩니다. Claude Code, Codex, Cursor, bash 스크립트, HTTP 웹훅까지 붙습니다. 에이전트를 만드는 프레임워크가 아니라는 점을 README가 분명히 하는데, 에이전트는 각자 가져오고 Paperclip은 그들이 일하는 조직을 관리한다는 구분입니다.

Orca와 겹치는 부분과 갈리는 부분

같은 주에 소개한 Orca도 에이전트 여러 개를 다룹니다. 둘 다 git worktree로 작업 공간을 나누고 휴대폰에서 상태를 봅니다.

갈리는 곳은 사람이 어디에 있느냐입니다. Orca는 사람이 화면 앞에 앉아 에이전트 다섯의 결과를 비교하고 고르는 도구입니다. Paperclip은 사람이 없는 동안 에이전트가 일정에 따라 일하고, 사람은 승인과 예산으로 개입하는 도구입니다. README도 에이전트가 하나면 Paperclip이 필요 없을 것이고 스무 개면 확실히 필요하다고, 그리고 코드 리뷰 도구가 아니라고 적어 둡니다. 코드를 짜는 순간에는 Orca 쪽이, 반복 업무를 맡겨 두는 쪽에는 Paperclip이 맞습니다.

설치 전에 볼 두 가지

빠른 시작은 기본으로 이 컴퓨터에서만 접속되는 신뢰 모드로 뜹니다. 같은 네트워크의 다른 기기나 Tailscale에서 접속하려면 --bind lan이나 --bind tailnet으로 인증 모드를 명시해야 합니다. 에이전트에게 비밀값과 코드 저장소를 맡기는 서버라 이 구분은 설치 첫날 정해 둘 일입니다.

설치 스크립트에는 체크섬 파일이 함께 있는데, README는 이 체크섬이 스크립트와 같은 서버에서 나온다는 한계까지 적어 두었습니다. 전송 오류는 잡지만 서버 자체가 오염되면 못 잡는다는 뜻이고, 독립적인 검증이 필요하면 GitHub의 특정 태그에 고정된 사본을 쓰라고 권합니다. 저는 자기 도구의 약점을 이렇게 먼저 밝히는 프로젝트를 조금 더 믿는 편입니다.

시험만 해 보려면 npx paperclipai test-drive가 CEO 에이전트 하나가 준비된 격리 인스턴스를 띄웁니다. 서비스를 설치하지 않고 첫 작업도 만들지 않으니, 회사를 차리기 전에 대시보드부터 둘러보기에 적당합니다.