Antonius Felix
AI & EngineeringPaperclip

Paperclip: Kelola Tim Agen AI Seperti Perusahaan, dari Instal sampai Anggaran

Oct 25, 2026/9 min read/Paperclip, AI agents, Claude Code, Codex, Hermes, open source
Ilustrasi konseptual tiga agen AI di bawah dua papan berklip: satu bertanda centang persetujuan, satu bergaris detak jantung, dengan tulisan Paperclip dan Tim agen AI
Ilustrasi konseptual, bukan tampilan aplikasi Paperclip.

Punya beberapa agen AI yang jalan sendiri-sendiri dan kamu lupa siapa mengerjakan apa? Paperclip menaruh semuanya di satu dashboard: tugas, peran, biaya, dan persetujuan. Kamu jadi pengawas, agen jadi tim.

Untuk apa Paperclip?

  • Satu tempat untuk banyak agen. Claude Code, Codex, Hermes, dan lainnya muncul di satu bagan organisasi. Docs resmi: kalau agen bisa menerima heartbeat, ia bisa direkrut.
  • Tugas jelas, bukan obrolan acak. Agen saling kerja lewat tiket. Dotta, pembuatnya, bilang ia tidak melihat banyak nilai dari “ruang rapat agen” (NetworkChuck 0:45).
  • Kamu tetap pegang kendali. Perekrutan agen menunggu persetujuanmu, dan biaya bisa dibatasi.
  • Pekerjaan berulang jalan sendiri. Routine membuat tiket sesuai jadwal.

Contoh dari video (klaim presenter):

  • Tim konten: periset, penulis, editor, lalu kamu menyetujui (Youri 5:33).
  • Newsletter dan kode: Tim menjalankan 5 agen selama 48 jam, sampai ada analisis dan pull request (Tech With Tim 1:02).
  • Tim IT: NetworkChuck memberi tiket “kenapa NAS putus tiap toilet di-flush” ke agen jaringan dan storage, lalu agen menemukan modul SFP bermasalah (NetworkChuck 18:23). Hasil itu klaim presenter, tidak saya verifikasi.
  • Tim produk Paperclip sendiri: Dotta bilang ia memakai Paperclip untuk membangun Paperclip, dengan CEO, CTO, UX, dan agen QA (Greg Isenberg 30:44). Ia juga menyebut template tim siap pakai, termasuk studio game (Greg Isenberg 40:28).

Cara kerjanya

  • Board: kamu. Menyetujui perekrutan, mengatur batas biaya, menjawab keputusan.
  • CEO: agen pertama. Menerima tujuan, memecah jadi tugas, mengajukan perekrutan.
  • Agen: pekerja dengan peran, adapter (Claude Code, Codex, dll), dan anggaran sendiri.
  • Issue (tugas): tiket dengan penerima, status, komentar, dan hubungan induk atau pemblokir.
  • Heartbeat: agen bangun saat ada tugas, pesan lanjutan, atau jadwal, lalu tidur lagi. Docs resmi: pengatur waktu bersifat opsional, agen tidak berjalan terus-menerus. Dotta membandingkan agen dengan tokoh film Memento yang bangun tanpa ingatan, jadi tiap bangun ia membaca daftar langkah tetap (Greg Isenberg 14:07).
  • Checkout atomik: satu tugas hanya diambil satu agen (docs resmi).
  • Routine: tugas berulang dengan jadwal cron, webhook, atau API. Tiap eksekusi jadi tiket dengan riwayat (docs resmi).
  • Skill: paket instruksi untuk agen. Dotta mencontohkan Remotion untuk video (Greg Isenberg 17:08).

Alurnya, singkat:

  1. Kamu menulis tujuan perusahaan.
  2. CEO mengajukan perekrutan, kamu setujui.
  3. Agen mengerjakan tiket, saling serah lewat komentar dan sub-tugas.
  4. Masalah naik ke CEO dulu, baru ke kamu (NetworkChuck 12:31).
  5. Kamu meninjau hasil dan keputusan.

Approval, budget, dan tombol darurat

  • Approval. Docs resmi mencantumkan tipe Hire Agent, CEO Strategy, Budget Override, dan Board Approval, dengan pilihan Approve, Reject, atau Request revision. Request revision cocok kalau usulannya masuk akal tapi perlu diubah.
  • Budget. Docs resmi: peringatan di 80% tidak menjeda agen. Di 100% agen dijeda otomatis sampai kamu menaikkan batas atau bulan UTC berikutnya. Youri menjelaskan hal yang sama (Youri 9:51). Catatan docs: di rilis v2026.1023.0 kartu peringatan masih tampil seperti hard stop, padahal agennya tidak dijeda.
  • Pause dan terminate. NetworkChuck menunjukkan tombol pause pada sub-pohon tugas saat agen keamanannya langsung minta reset password massal (NetworkChuck 25:12).

Instal langkah demi langkah

Sumber: README dan docs resmi, kecuali disebut lain.

Prasyarat

  • Node.js 24.11.0 atau lebih baru. Cek dengan node --version.
  • Satu agen yang siap pakai di mesin tempat Paperclip jalan: CLI Claude Code atau Codex yang sudah login, atau kunci API.
  • Baca syarat layanan penyedia kalau memakai langganan untuk otomasi terus-menerus. Tim mengingatkan hal ini (Tech With Tim 7:20). Saya tidak memeriksa syarat tiap penyedia.

Coba di komputer sendiri (paling ringan)

npx paperclipai@latest onboard --yes
  • Hasilnya instans lokal tanpa login, dengan database Postgres tertanam otomatis. Buka http://localhost:3100.
  • Mau mengakses dari perangkat lain di jaringan pribadi, tambahkan --bind lan atau --bind tailnet. Mode ini memakai login.
  • Kalau sudah ada konfigurasi, menjalankan onboard lagi tidak menimpanya. Ubah pengaturan dengan npx paperclipai configure.

Uji terisolasi tanpa memasang service

ANTHROPIC_API_KEY=... npx paperclipai test-drive
  • Berjalan di foreground dengan folder data sementara (path-nya dicetak saat mulai) dan CEO yang sudah siap. Ada opsi --harness codex dan --harness opencode (lihat README).
  • Jangan menempel kunci asli di terminal bersama atau riwayat yang dibagikan.

Pasang menetap

  • npx paperclipai install memasang perintah paperclipai ke ~/.local/bin, dengan update dan rollback. Lalu paperclipai onboard dan paperclipai run.
  • Alternatif ala NetworkChuck: unduh https://paperclip.ing/install.sh, baca isinya, lalu jalankan (NetworkChuck 6:08). Panduan pendampingnya menyarankan memeriksa berkas install.sh.sha256 dulu. Panduan itu dibuat pihak ketiga dan diuji di versi 2026.916.1.
  • Di server, NetworkChuck memilih setup lanjutan agar bisa dibuka lewat jaringan lokal, lalu membuka port 3100 (NetworkChuck 6:25).

Server 24 jam (VPS)

  • Laptop yang tidur membuat agen berhenti. Karena itu Tim dan Youri memilih VPS (Tech With Tim 3:48, Youri 1:35). Keduanya memakai templat Hostinger. Youri menyebut minimal paket KVM 2 (2 CPU, 8 GB RAM). Link Hostinger milik Youri adalah afiliasi, jadi tidak saya pakai di sini.
  • Docs resmi punya panduan Docker dan mode deployment sendiri. Instans yang bisa diakses internet wajib memakai mode authenticated.

Menyambungkan adapter

  • Claude Code: pasang dan login di mesin Paperclip, lalu pilih adapter ini untuk CEO. Kalau agen gagal di run pertama, biasanya CLI belum terpasang. NetworkChuck mengalaminya, memasang Claude Code, login, lalu menekan Retry (NetworkChuck 7:16).
  • Codex: di server tanpa layar, Tim memakai codex login --device-auth untuk login lewat kode (Tech With Tim 13:52).
  • Hermes: adapter Hermes Gateway untuk Hermes yang jalan di mesin lain. Docs resmi: isi apiBaseUrl dan apiKey (sama dengan API_SERVER_KEY Hermes, tersimpan sebagai secret). Pakai HTTPS atau jaringan privat seperti Tailscale, bukan HTTP biasa ke host non-lokal.
  • Pi dengan model lokal: NetworkChuck memakainya untuk tugas ringan seperti helpdesk (NetworkChuck 2:56).
  • Lainnya (docs resmi): Cursor (dan Cloud), Gemini CLI, OpenCode, Grok Build, Kimi Code, OpenClaw Gateway, Process, dan HTTP.
  • Di tiap agen ada tombol “Test now” untuk memeriksa adapter sebelum dipakai (Tech With Tim 19:00).

Contoh pertama: tim konten kecil

Alur ini mengikuti cara Youri dan Tim, bukan hasil uji saya.

  1. Buat perusahaan dengan tujuan satu kalimat, misalnya “terbitkan satu artikel AI per minggu”. Tim menyarankan misi yang spesifik, bukan karangan panjang.
  2. Rekrut CEO dengan Claude Code.
  3. Buat tiket untuk CEO: “hire a research agent yang mencari topik AI tren dan menyusun brief”. Setujui permintaan di Inbox (Youri 5:59).
  4. Ulangi untuk penulis dan editor. Tulis persona yang jelas: format brief, panduan suara, kriteria revisi.
  5. Beri CEO instruksi per heartbeat, misalnya cek status, tinjau hasil, beri kerja ke agen yang menganggur, tinjau metrik (Tech With Tim 35:29). Tanpa itu CEO bisa melapor “tidak ada kerjaan” lalu tidur.
  6. Atur routine mingguan dan batas anggaran per agen.
  7. Jaga tim tetap kecil. Tim: 7 sampai 15 agen sudah lebih dari cukup (Tech With Tim 33:44).

Kalau agen kode dilibatkan, wajibkan ia membuat branch dan pull request, bukan push langsung ke main (Tech With Tim 28:22).

Biaya

  • Paperclip gratis dan sumber terbuka (lisensi MIT).
  • Yang berbayar: model (API per token atau langganan), server, dan waktu meninjau.
  • Docs resmi memperingatkan: setiap heartbeat, tugas, dan komentar bisa memanggil model berbayar.
  • Dashboard bisa menunjukkan $0 kalau agen memakai langganan. Dotta menjelaskan itu bukan inferensi gratis, hanya biayanya ada di langganan (Greg Isenberg 24:06). Docs resmi melacak biaya langganan terpisah.
  • Untuk menghemat: CEO pakai model kuat, tugas mekanis pakai model lebih murah atau lokal (Youri 1:07). Saya tidak menemukan angka penghematan yang bisa dipertanggungjawabkan.
  • Pasang budget per agen sebelum agen berjalan lama.

Keamanan

  • Agen menjalankan CLI di mesinmu dan bisa membaca atau mengubah file. Perlakukan seperti karyawan baru dengan akses server.
  • Mode default local_trusted tidak meminta login. Jangan buka ke internet dalam mode itu.
  • Simpan kunci di Secrets Paperclip dan batasi per agen. NetworkChuck memberi kunci Flare hanya ke satu agen (NetworkChuck 23:41). Bagian Flare di video itu adalah iklan sponsor.
  • Skill pihak ketiga: Dotta mengakui keamanannya belum selesai, hanya ada badge audit dan jumlah bintang sebagai petunjuk (Greg Isenberg 18:42). Baca isi skill sebelum memasang.
  • Beri persetujuan sebelum aksi yang tidak bisa dibatalkan, seperti reset password atau ubah aturan jaringan.
  • Paket export bisa memuat nilai env biasa dan path lokal. Periksa dulu sebelum dibagikan (README).
  • Telemetri anonim aktif secara default. Matikan dengan PAPERCLIP_TELEMETRY_DISABLED=1 atau DO_NOT_TRACK=1 (README).

Kalau ada masalah

  • Agen gagal di run pertama: pastikan CLI-nya terpasang dan login di mesin Paperclip, bukan hanya di laptopmu. Lalu Retry.
  • npx error E404: kemungkinan registry npm privat di ~/.npmrc. Pakai npx --registry https://registry.npmjs.org paperclipai@latest onboard --yes (README).
  • Peringatan versi Node: pakai 24.11 atau lebih baru.
  • Agen berhenti mendadak: cek apakah anggarannya sudah 100%.
  • Tiket diam: cek penerima, status blocked, dan apakah CEO punya instruksi heartbeat yang jelas.
  • Heartbeat macet: docs resmi punya panduan “Debug a Stuck Heartbeat”.
  • Agen pemindai sering timeout: NetworkChuck melihatnya pada agen lokalnya (NetworkChuck 12:59). Kecilkan cakupan tugas.
  • Beda dengan video: tampilan dan fitur berubah cepat. Video tayang Maret sampai September 2026, sedangkan rilis terbaru yang saya cek adalah v2026.1023.0. Fitur Cases, misalnya, masih di bagian Experimental di docs.

Kapan sebaiknya tidak pakai Paperclip

  • Satu proyek kecil sekali jalan. Tim sendiri bilang Paperclip berlebihan untuk tugas sederhana (Tech With Tim 37:49). Pakai Claude Code langsung.
  • Satu agen saja belum memberi hasil bagus. Youri: Paperclip menggandakan masalah dan menghabiskan kredit, dan agen tunggal yang disetel baik sering lebih baik (Youri 10:40).
  • Kamu tidak sempat meninjau. Tim masih harus membuka blokir tiket secara manual (Tech With Tim 29:31).
  • Kamu tidak mau mengurus server dan akses.
  • Kamu berharap bisnis jalan tanpa manusia. Dotta menyebut “zero-human” masih aspirasi (Greg Isenberg 2:48).

Sumber

Repo dan docs resmi

Empat video

Tautan di atas bukan embed dan tidak ada video yang saya unggah ulang. Saya tidak berafiliasi dengan Paperclip maupun para kreator. Untuk NetworkChuck, pengambilan ulang transkrip lewat Agent Reach sempat kena batas laju (HTTP 429), jadi saya memakai transkrip dari pengambilan sebelumnya yang hash-nya tersimpan.

More Toolkits & Guides
Based in Jakarta
Digital Business research and collaboration

Let's build it as one system.