almost-cli, BYOK çoklu ajanlı kodlamayı yerel makinenize getiriyor

Hosted kodlama asistanlarına bir alternatif

wellparth adıyla yayın yapan bir geliştirici, yerel bir kod tabanına karşı uzmanlaşmış kodlama ajanlarından oluşan bir ekibi çalıştıran bir komut satırı aracı olan almost-cli'yi açık kaynak yaptı. dev.to'daki duyuru yazısına göre proje, ana akım kodlama asistanına bilinçli bir karşı çıkış: bulutta hiçbir çıkarım (inference) yapılmıyor, arka uç hesabı gerekmiyor ve model erişimi araçtan kiralanmıyor. Bunun yerine kullanıcılar kendi API anahtarlarını sağlıyor — OpenAI, Gemini, DeepSeek veya NVIDIA NIM için — ve hem anahtarlar hem de kaynak kodu kullanıcının makinesinde kalıyor.

Araç, işin farklı aşamaları için birbirinden ayrı ajan rolleri tanımlıyor: Architect, Planner, Builder, Tester ve Debugger. Bu ajanlar tek bir monolitik asistan gibi davranmak yerine yerel depoda birlikte çalışıyor.

Ajanlar konfigürasyon, modeller runtime'dır

dev.to yazısı, aracın merkezindeki tasarım fikrini bir ajanın ne olduğu ile onu çalıştıran model arasındaki keskin bir ayrım olarak çerçeveliyor. Bu şemada bir ajan; system prompt, araç seti, izinler ve iş akışından oluşan bir konfigürasyonken, altındaki dil modeli yalnızca bir runtime olarak ele alınıyor. Bunun pratik getirisi ajan başına model yönlendirmesi: planlama için ucuz bir model atanırken, hata ayıklama için daha güçlü bir model ayrı tutulabiliyor ve sağlayıcılar ajanların davranışını değiştirmeden ajan bazında değiştirilebiliyor.

Varsayılan olarak reddeden izinler

Yazıya göre yığın katmanlı yapıda:

• CLI ve TUI, bir Agent Orchestrator ile iletişim kuruyor.
• Orchestrator; bir Agent Runtime, Context Engine ve Permission Engine'i koordine ediyor.
• Ajanlar Filesystem, Shell, Git, Search ve MCP'yi kapsayan açık araç setleriyle çalışıyor.
• İzinler varsayılan olarak reddediliyor, her araç çağrısı denetleniyor ve MCP sunucuları araç bazında kısıtlanıyor.

Son madde, ajanları shell komutları çalıştırıp dosyaları değiştirebilen bir araç için önemli. Çoklu ajan kurulumları istenmeyen eylemler için saldırı yüzeyini büyütür ve her araç çağrısını — MCP sunucularına yapılan çağrılar dahil — denetlemek, daha geniş ajan ekosisteminin savunduğu türden bir koruma tedbiridir. Uygulamanın pratikte ne kadar sağlam olduğu şu aşamada henüz test edilmiş değil.

Birinci gününde monorepo

Kod, GitHub'da pnpm tabanlı bir monorepo olarak duruyor: apps/cli paketinin yanında agent-core, providers, tools, permissions, context, orchestrator, sessions, storage ve agent-definitions için kütüphaneler, ayrıca tanımların kendisini barındıran bir agents dizini bulunuyor. Başlamak için standart pnpm sırası izleniyor: install, typecheck, test ve build.

Vurgulanması gereken bir uyarı var: yazar, yazıyı geliştirmenin ilk gününde yazıldığını ve projenin halka açık bir şekilde, açıkça issue ve geri bildirim istenerek geliştirildiğini söylüyor. Bu, en erken aşamasındaki bir deney, bitmiş bir ürün değil ve değerlendiren herkes kaba kenarlar beklemeli.

Neden önemli

Popüler kodlama asistanlarının çoğu model erişimini bir bulut hizmetiyle paketler; bu da kodun ve bağlamın geliştiricinin makinesinden çıkması anlamına gelir ve sağlayıcı ilişkisi kilitlenmeye (lock-in) yönelir. Bring-your-own-key, yerel öncelikli bir araç bu düzeni tersine çevirir: geliştirici verinin, anahtarların ve ajan tanımlarının sahibidir ve maliyet ile yetenek arasında denge kurmak için sağlayıcıları görev görev harmanlayabilir. Yazının da kabul ettiği gibi bedel, kullanıcının operasyonu da sahiplenmesidir — anahtar yönetimi, model seçimleri ve yol boyunca bozulan her şey.

Güvenlik veya uyumluluk kısıtlamaları olan ekipler ve deny-by-default araç izinleri ile ajan bazında model yönlendirmesi gibi ajan güvenliği desenlerinin nasıl yerleştiğini izleyenler için almost-cli'ye bir göz atmak değerli — bugün günlük kullanım aracı olarak değil, daha çok bulut asistanı varsayılanına meydan okuyan bir tasarım felsefesinin açık bir referans uygulaması olarak.