Paperclip: Yapay Zeka Ekibinizi Oluşturan Ücretsiz Araç

Çok sayıda yapay zeka aracısı çalıştıran çoğu geliştirici, beşinci aracının etrafında aynı sorunla karşılaşır. Bir terminalde arka uç hizmetini yeniden yazan Claude Code'unuz, başka bir terminalde testler üreten Codex'iniz, bir bileşeni düzenleyen Cursor'unuz ve kontrol etmeyi unuttuğunuz üç sekmeniz var. Kimse kimin ne yaptığını bilmiyor. Maliyetler yükseliyor. İki aracı aynı işi tekrarlıyor. Biri altı saat çalışıyor ve kimse ona net bir hedef vermediği için hiçbir işe yarar şey üretmiyor. Paperclip bunu düzeltiyor. Dağınık yapay zeka aracılarınızı, kuruluş şemaları, atanmış roller, görev yönetimi, bütçe limitleri ve denetim günlükleriyle eksiksiz, yapılandırılmış bir şirkete dönüştüren açık kaynaklı bir orkestrasyon platformudur. Üç haftadan kısa sürede 35.000'den fazla GitHub yıldızına ulaştı, bu da kaç geliştiricinin aynı hayal kırıklığıyla oturduğunu gösteriyor. button Bu makale, onu kurma, ilk aracı şirketinizi yapılandırma ve her terminali izlemeden işlerin gerçekten yapılmasını sağlayacak şekilde çalıştırma konusunda size yol gösterecektir.

Paperclip nedir (ve ne değildir)

Herhangi bir şey kurmadan önce, ne elde ettiğinizi anlayın. [Paperclip](https://github.com/paperclipai/paperclip) bir **orkestrasyon katmanıdır**. Aracılarla koordinasyon kurar, işlerini takip eder, bütçelerini kontrol eder ve onlara şirketin hedefleri hakkında bağlam sağlar. Aracıları inşa etmez, yapay zeka sağlayıcınızı değiştirmez veya bir sohbet arayüzü eklemez.

Paperclip ekibinin kullandığı zihinsel model: "Eğer Claude Code bir çalışan ise, Paperclip şirkettir." Bu şu anlama gelir: *   Aracıların sadece istemleri değil, **rolleri** vardır. *   Görevlerin sadece açık terminalleri değil, **sahipleri** vardır. *   Bütçelerin sadece "havaları" değil, **katı limitleri** vardır. *   Her şey bir **denetim izinde** günlüğe kaydedilir. Paperclip; Claude Code, OpenAI Codex, Cursor, Gemini CLI ve bir webhook veya kalp atışı sinyali alabilen herhangi bir aracıyla çalışır. Aracılar sizden. Şirketi Paperclip yönetir. Açıkça şunlar değildir: *   Bir sohbet botu kullanıcı arayüzü *   n8n veya Zapier gibi sürükle ve bırak iş akışı oluşturucu *   Aracı yazmak için bir çerçeve *   Tek aracılı kullanım durumları için faydalı Eğer arada sırada tek bir yapay zeka aracısı çalıştırıyorsanız, Paperclip aşırıya kaçar. Eğer devam eden işlerde üç veya daha fazla aracı çalıştırıyorsanız, eksik parça odur.

Paperclip Kurulumu

Node.js 20+, pnpm 9.15+ ve hepsi bu kadar. Paperclip, gömülü bir PostgreSQL veritabanıyla birlikte gelir, bu nedenle harici depolama kurmanıza gerek yoktur. **Başlamak için en hızlı yol:** ```bash npx paperclipai onboard --yes ``` Bu, CLI'yi indirir, mantıklı varsayılanlarla kurulumu çalıştırır ve sunucuyu 3100 numaralı bağlantı noktasında başlatır. `http://127.0.0.1:3100` adresini açın ve gösterge paneline bakıyorsunuzdur. **Katkıda bulunmak veya kodu incelemek isterseniz:** ```bash git clone https://github.com/paperclipai/paperclip.git cd paperclip pnpm install pnpm dev ``` **Docker'ı tercih ederseniz:** ```bash docker compose -f docker-compose.quickstart.yml up --build ``` **Diske ne oluşturulur:** Paperclip her şeyi `~/.paperclip/instances/default/` altına kaydeder: ``` ~/.paperclip/instances/default/ config.json          — sunucu ve depolama ayarları db/                  — gömülü PostgreSQL veri dosyaları secrets/master.key   — şifreleme anahtarı (otomatik oluşturulmuş) logs/                — sunucu günlükleri data/storage/        — dosya ekleri workspaces//  — aracıya özel çalışma dizinleri ``` Yerel mod, varsayılan olarak `local_trusted` kimlik doğrulamasını kullanır, bu da oturum açmayı atlar ve sentetik bir "Yönetim Kurulu" kullanıcısı kullanır. Gösterge panelini hemen kullanmaya başlayabilirsiniz, hesap oluşturmaya gerek yoktur. İçeri girdikten sonra sağlık kontrolünü çalıştırın: ```bash paperclipai doctor ``` Herhangi bir şey yanlış yapılandırılmışsa, `--repair` çoğu sorunu otomatik olarak düzeltir: ```bash paperclipai doctor --repair ```

İlk şirketinizi kurmaPaperclip'te bir "şirket", aracılarınız, görevleriniz, hedefleriniz ve bütçeleriniz için üst düzey kapsayıcıdır. Bunu bir proje gibi düşünün, ancak her proje üyesi bir rolü ve raporlama çizgisi olan bir yapay zeka aracısıdır. Gösterge panelinden yeni bir şirket oluşturun ve ona bir misyon ifadesi verin. Bu dekoratif değildir. Bir aracının aldığı her görev, şirketin misyonuna kadar uzanır, böylece aracılar sadece *ne* yapacaklarını değil, *neden* bu işi yaptıklarına dair bağlama sahip olurlar. Bu, daha uzun aracılı çalışmalarda karar verme için önemlidir. Basit bir örnek misyon: "Müşteri sipariş yönetimi için bir REST API oluştur ve sürdür. Hızı doğruluğa tercih et. Herkese açık her uç noktayı belgele." Bu tek ifade, aracılarınıza yaptıkları her karar için bir filtre sağlar.

İlk aracılarınızı eklemePaperclip'teki her aracının, hangi yapay zeka aracını kullandığını ve nasıl iletişim kurduğunu tanımlayan bir **adaptörü** vardır. Kutudan çıktığı gibi desteklenen adaptörler:

CLI aracılığıyla bir Claude Code aracısı eklemek için: ```bash paperclipai agent local-cli "Backend Engineer" --company-id <şirket-kimliğiniz> ``` Bu, aracıyı başlatır, becerilerini `~/.claude/skills` içine kurar ve API kimlik bilgilerini oluşturur. Aracı artık şirketinizin organizasyon şemasında yer alır ve görev atamaları alabilir. **Bir Claude aracısını yapılandırma** (UI'da veya aracı başına yapılandırmada ayarlanır):

**Role göre model tahsisi**, başlamadan önce düşünmeye değerdir. Her aracıda Opus çalıştırmak hızla pahalı hale gelir. Pratik bir ayrım: *   **CEO / orkestrasyon aracıları:** Sonnet (stratejik akıl yürütme, maliyetine değer) *   **Yönetici aracıları:** Haiku (yönlendirme ve görevlendirme, ucuz ve hızlı) *   **Yaratıcı / kodlama IC'leri:** Sonnet (burada çıktı kalitesi önemlidir) *   **Formüle dayalı IC'ler:** Haiku (kalıplaşmış kod üretimi, test iskeleti, geçişler) Bu tahsis, rutin görevlerde anlamlı bir kalite kaybı olmaksızın, her yerde Sonnet çalıştırmaya kıyasla aylık aracı harcamanızı %40-60 oranında azaltabilir.

Aracı organizasyonunuzu yapılandırmaİşte küçük bir yazılım projesi için işleyen bir yapı: ``` CEO (Sonnet) ├── CTO (Haiku) │    ├── Backend Mühendisi (Sonnet) │    ├── Frontend Mühendisi (Sonnet) │    └── QA Mühendisi (Haiku) └── Teknik Yazar (Haiku) ``` CEO ajanı misyonu elinde tutar ve onu hedeflere böler. CTO, hedefleri mühendislik ajanlarına yönlendirir. Mühendisler işi yapar. QA doğrular. Yazar belgeler. Her aracının bir **kalp atışı aralığı** vardır, yani uyanma, atanmış görevlerini kontrol etme, iş yapma ve çıkma sıklığı. Aracılar sürekli çalışmaz. Uyanır, yürütür ve uyurlar. Maliyetlerin yükselmesini engelleyen şey budur. Önerilen aralıklar: *   Kodlama ajanları: 600 saniye (10 dakika) *   Talep üzerine ajanlar: 86.400 saniye (günde bir kez) talep üzerine uyanma etkinleştirilmiş olarak *   Minimum güvenli aralık: 30 saniye (bundan daha düşüğü maliyet aşımları ve spam riski taşır)

Kalp atışı nasıl çalışır?Kalp atışı modelini anlamak, ajanlarınızdan güvenilir iş almak için anahtardır. Bir ajan her uyandığında, dokuz adımlı bir protokolü izler: 1.  Kimliği `GET /api/agents/me` aracılığıyla onaylayın 2.  Bekleyen onay geri çağrılarını işleyin 3.  `GET /api/companies/{companyId}/issues` adresinden atanmış görevleri getirin 4.  Önceliklendirin: önce devam eden görevler, sonra yapılacaklar; engellenmiş görevleri, engeli kaldırılamazlarsa atlayın 5.  `POST /api/issues/{issueId}/checkout` aracılığıyla görevi teslim alın (başka bir ajan zaten aldıysa, yanıt 409'dur ve bu ajan devam eder) 6.  Tam görev bağlamını ve yorum dizisini okuyun 7.  İşi yapın 8.  Görevi yorumlar ve durum değişiklikleriyle güncelleyin 9.  Gerekirse üst ve hedef kimlikleriyle alt görevleri devredin 5. adımdaki teslim alma mekanizması, tekrarlanan işi önleyen şeydir. İki ajan aynı görevi alamaz. Biri üzerinde çalışıyorsa, diğeri onu otomatik olarak atlar. Paperclip, her ajan çalışmasına ortam değişkenleri aracılığıyla bağlam enjekte eder: ```bash PAPERCLIP_TASK_ID          # bu çalışmayı hangi görevin tetiklediği PAPERCLIP_WAKE_REASON      # ajanın neden uyandığı (zamanlayıcı, bahsetme, atama) PAPERCLIP_AGENT_ID         # ajanın kimliği PAPERCLIP_API_URL          # Paperclip'in API'sine geri arama URL'si ``` Ajanlar bunları güncelleme göndermek, alt görevler oluşturmak, onay istemek ve görevlendirmek için kullanabilirler — hepsi tek bir kalp atışı içinde.

Görev atama ve iş takibiPaperclip'teki görevler, GitHub sorunları ile bir proje yönetim aracının birleşimi gibi çalışır. Kullanıcı arayüzünden veya CLI'dan bir tane oluşturun: ```bash paperclipai issue create \ --company-id  \ --title "Siparişler uç noktasına sayfalama ekle" \ --assignee-agent-id ``` Görevler şunlara sahip olabilir: *   Büyük işleri alt görevlere ayırmak için **üst görevler** *   Aracıların bu hedefin şirketin hangi hedefine hizmet ettiğini bilmeleri için **hedef bağlantıları** *   Bağlam, onay istekleri ve durum güncellemeleri için **yorumlar** *   Belirli bir aracıyı talep üzerine uyandırmak için **@-bahsetmeler** (bir sonraki kalp atışını beklemeye gerek yok) Tüm açık görevleri CLI'dan görüntüleyebilirsiniz: ```bash paperclipai issue list ``` Veya gösterge panelinde, görevler mevcut sahibini, durumunu ve hangi kalp atışı çalışmasının en son dokunduğunu gösterir.

Gerçekten işe yarayan bütçe kontrolüBu, Paperclip'teki en kullanışlı özelliklerden biridir ve çoklu aracı kurulumlarına yeni başlayanlar tarafından en çok göz ardı edilenidir. Her aracıya aylık bir token bütçesi verilir. %80'e ulaştığında, aracı otomatik olarak yalnızca kritik görevlere geçer. %100'e ulaştığında, tamamen duraklatılır. Aracı yapılandırmasında bir bütçe belirleyin. Topluluk tarafından önerilen başlangıç noktası, aracı katmanı başına ayda 20-50$'dır. Her aracı için yakım oranını, kalp atışı başına maliyeti ve kümülatif aylık harcamayı gösterge panelinden takip edebilirsiniz. Maliyet gösterge paneli, hangi ajanların verimli olduğunu ve hangilerinin odaklanmamış işlere token harcadığını gösterir. Bir ajanın kalp atışı başına maliyeti artıyorsa, bu genellikle istemlerin çok belirsiz veya görev kapsamının çok geniş olduğunun bir işaretidir. Bunu, bütçeyi artırarak değil, atamayı sıkılaştırarak düzeltirsiniz. Bütçe kontrolleri olmadan, Extended Thinking (Genişletilmiş Düşünme) etkinleştirilmiş 30 saniyelik bir aralıkta çalışan yanlış yapılandırılmış bir ajan, siz fark etmeden yüzlerce dolar harcayabilir. Paperclip bunun otomatik olarak olmasını engeller.

Çalışma zamanı becerileri: yeniden eğitim olmadan aracılara yeni iş akışları öğretmePaperclip'teki daha güçlü özelliklerden biri **beceri enjeksiyonu**dur. Bir aracı çalıştığında, Paperclip'in adaptörü aracının yapılandırma dizinindeki `SKILL.md` dosyalarına sembolik bağlantılar oluşturur ve bunları `--add-dir` aracılığıyla geçirir. Aracı, beceri dosyasını bağlamının bir parçası olarak okur ve iş akışını takip eder. Bu, bir aracıyı taahhüt mesajları yazma, veritabanı geçişlerini ele alma veya API belgelerini biçimlendirme gibi yeni bir süreci, bir markdown dosyası yazarak öğretebileceğiniz anlamına gelir. İstem yeniden yazımı yok. Yeniden dağıtım yok. Beceriyi siz yazarsınız: ```markdown # BECERİ: Veritabanı geçişleri Bir geçiş oluştururken: 1. Mevcut geçiş dosyalarını asla değiştirmeyin 2. Açıklayıcı adlar kullanın: YYYYAA_açıklama.sql 3. Hem yukarı hem de aşağı SQL'i dahil edin 4. Taahhüt etmeden önce yerel olarak test edin 5. Değişikliğin iş nedenini açıklayan bir yorum ekleyin ``` Beceri dizinine kaydedin, arka uç aracınıza atayın ve her gelecek kalp atışı o süreci takip eder.

Aracılarınız tarafından oluşturulan API'leri test ediyorsanızAracılarınız API'ler oluşturduğunda, ürettiklerini hızlı bir şekilde test etmeniz gerekir. [Apidog](https://apidog.com) burada doğal olarak uyar. API tasarımı, sahte sunucular ve otomatik testleri tek bir yerde halleder, böylece arka uç aracınız bir uç nokta gönderdiğinde, Swagger, Postman ve ayrı bir sahte araç arasında geçiş yapmadan hemen doğrulayabilirsiniz.

OpenAPI spesifikasyonunuzdan test süitlerini otomatik olarak oluşturabilir, bunları aracının çıktısına karşı çalıştırabilir ve sonuçları görev yorumu olarak geri besleyebilirsiniz. Aracı bir sonraki kalp atışında onu alır ve hataları düzeltir. Koddan teste, düzeltmeye kadar tüm döngü, ortada insan olmadan çalışır. Apidog, REST, GraphQL ve gRPC'yi destekler ve başlamak ücretsizdir.

Birden fazla örneği yönetmePaperclip, `PAPERCLIP_INSTANCE_ID` ortam değişkeni veya `--instance` bayrağı aracılığıyla tek bir makinede birden çok izole örneği destekler. Her örneğin kendi yapılandırması, veritabanı, bağlantı noktaları ve çalışma alanları vardır. Yerel geliştirme için, `worktree` komutu her git dalı için tamamen izole edilmiş bir geliştirme örneği oluşturur: ```bash paperclipai worktree:make feature/orders-pagination ``` Bu size o dala özgü ayrı bağlantı noktaları, yapılandırma ve bir veritabanı verir. Üretim aracısı kurulumunuza dokunmadan özellik koduna karşı bir test şirketi çalıştırabilirsiniz. İşiniz bittiğinde, onu yıkın ve gitmiş olur.

Çalışan çoklu ajan kurulumlarıTemelleri çalıştırdıktan sonra iyi çalışan birkaç model: **Hedef basamaklandırma:** Şirket düzeyinde bir üst düzey hedef yazın, ardından CEO aracınızın bunu proje hedeflerine bölmesine ve her yönetici aracının bunları görevlere bölmesine izin verin. Ajanlar, izole talimatlar almak yerine amacın zincirini anladıklarında daha iyi iş çıkarırlar. **Onay geçitleri:** Üretim, hazırlık ortamları veya faturalandırma ile ilgili herhangi bir ajan eylemi için bir onay geçidi yapılandırın. Ajan duraklar, size bir bildirim gönderir ve devam etmeden önce bir başparmak yukarı bekler. Bir manuel adım ekler, ancak pahalı hale gelmeden önce sorunları yakalar. **@bahsetme yoluyla talep üzerine uyanma:** Hızlı bir kalp atışı aralığı yerine (ve bununla gelen token maliyeti), ajanları yavaş bir aralığa ayarlayın ve gerektiğinde onları hemen uyandırmak için görev yorumlarında @bahsetmeler kullanın. Sürekli yoklama için ödeme yapmadan önemli işlerde hızlı yanıt süreleri elde edersiniz. **Her ajan için ayrı çalışma alanı:** Her ajanın `workspaces//` altında kendi çalışma dizini vardır. Bunları temiz tutun. Aynı çalışma alanını paylaşan ajanlar birbirlerinin işine basar. İzolasyon yerleşiktir; onunla savaşmayın.

Başlamak yaklaşık 15 dakika sürerİlk seferde, katılım 15 dakikadan kısa sürer. Tek bir komut sunucuyu kurar ve başlatır. İlk aracınızı eklemek ve bir görev oluşturmak gösterge panelinde beş dakika daha sürer. Daha zor olan kısım, şirketinizi iyi yapılandırmaktır: açık bir misyon yazmak, her rol için doğru modeli seçmek ve mantıklı bütçe limitleri belirlemek. İş atamaya başlamadan önce buna 30 dakika harcayın, aksi takdirde her şeyi hızlıca kurup en iyisini ummaktan çok daha iyi sonuçlar alırsınız. Eğer herhangi bir devam eden projede zaten iki veya daha fazla yapay zeka aracısı çalıştırıyorsanız, bu, bir öğleden sonra kurulumuna değer. Her ajan için bir terminal sekmesi ile bütçe kontrolleri, görev sahipliği ve denetim günlüklerine sahip yapılandırılmış bir şirket arasındaki fark, bir yan proje ile gerçekten denetimsiz çalışabilen bir şey arasındaki farktır.