kosa8

Claude Code için kosa8 eklentisi

kosa8: Yapay zekâ ajanları için güvenli altyapı.

Claude'a çalışabileceği, yalıtılmış bir makine verin. Bu eklenti, Claude Code'u kosa8 ile bağlar: yapay zekâ ajanları için güvenli altyapı. Her ajan, kendi çekirdeğine sahip gerçek bir microVM olan, ana makinenin çekirdeğini paylaşmayan yalıtılmış bir makine alır.

Eklenti etkinleştirildiğinde Claude şunları yapabilir:

• güvenilmeyen veya ajan tarafından yazılmış kodu, ana makinede yalnızca tek bir klasörü (çalışma alanını) görebilen yalıtılmış bir microVM'de çalıştırabilir;
• yalnızca sizin yazdığınız izin listesindeki ana makinelerin erişilebilir olduğu, diğer tüm bağlantıların reddedildiği kapalı bir ağın arkasında çalışabilir;
• API anahtarlarını elinde tutmadan kullanabilir: ana makinedeki bir çıkış aracısı, anahtarları dışarı giden isteklere ekler ve korumalı alan yalnızca bir yer tutucu tutar;
• riskli bir adımdan önce çalışan makinenin tamamını, belleği ve süreçleriyle birlikte yaklaşık 0,7 saniyede kontrol noktasına kaydedebilir ve bir sorun olduğunda çalışır durumdayken yaklaşık bir saniyede geri alabilir;
• yaklaşımları paralel denemek ve işe yarayanı tutmak için çalışan bir makineyi canlı kopyalara çatallayabilir;
• riskli işlemler için adı belirtilmiş bir veya iki insan onaylayıcıyı bekleyebilir (iki kişi kuralı); her işlem, karma zincirli ve kurcalamaya karşı korumalı bir denetim günlüğüne yazılır.

Eklenti dört bölümden oluşur:

• Bir MCP sunucusu (.mcp.json); kosa8 mcp serve öğesini scripts/kosa8-mcp üzerinden yerel bir stdio süreci olarak başlatır.
• Bir beceri (skills/kosa8-sandbox); Claude'a korumalı alanı ne zaman kullanacağını ve kontrol noktalarını, geri almayı, çatallamayı, çıkış izin listelerini ve onayları güvenli biçimde nasıl kullanacağını söyler.
• Komutlar: /kosa8:status, /kosa8:sandbox <task>, /kosa8:checkpoint, /kosa8:rewind (geri almadan önce sorar) ve /kosa8:explore (birkaç komutu paralel çatallarda dener).
• Ajanlar: sandbox-runner, güvenilmeyen veya oluşturulmuş kodu yalıtılmış bir microVM'de çalıştırır ve yaptıklarını bildirir; fork-explorer, çalışan tek bir korumalı alanın paralel çatallarındaki yaklaşımları karşılaştırır.

Ön koşullar

• Claude Code.
• Aynı makinede kurulu kosa8 ve PATH üzerinde kosa8. kosa8, Apple çipli Mac'lerde ve x86-64 Linux'ta, ayrıca Windows'ta WSL2 üzerinden (önizleme) çalışır. kosa8.com/download adresinden yükleyin. Sürümler imzalanır ve noter tasdiklidir. Kurulumu kosa8 version ile doğrulayın.
• kosa8 arka plan hizmeti çalışıyor olmalıdır. Eklenti yalnızca ince bir başlatıcıdır: korumalı alanlar makinenizde kosa8d tarafından çalıştırılan microVM'lerdir; bu nedenle hizmet çalışmıyorsa hiçbir şey çalışmaz.

Başlamadan önce: kosa8'i yükleyin ve arka plan hizmetini başlatın

Eklenti kosa8'i yüklemez ve kosa8 olmadan çalışamaz. Yeni bir makinede:

# 1. Install kosa8 (macOS on Apple silicon, x86-64 Linux, or WSL2)
#    from https://kosa8.com/download/, then check it:
kosa8 version

# 2. Start the daemon that runs the microVMs:
kosa8 daemon start

# 3. Confirm both halves are up:
kosa8 version          # prints "kosa8 daemon <version> (up Ns)"
kosa8 mcp tools        # lists the tools this plugin exposes

kosa8 version, kosa8 daemon: not running sonucunu verirse kosa8 daemon start komutunu yeniden çalıştırın. MCP sunucusu arka plan hizmeti olmadan başlar, ancak bu durumda her korumalı alan aracı cannot reach kosa8d yanıtını verir.

Bu sunucuyu bir kullanıcı için yükleyen ajanlar llms-install.md dosyasındaki adımları izleyebilir.

Yükleme

Claude Code'da bu depoyu bir pazar yeri olarak ekleyin ve eklentiyi yükleyin:

/plugin marketplace add kosa8ai/kosa8-claude-plugin
/plugin install kosa8@kosa8

Ya da kabuğunuzdan:

claude plugin marketplace add kosa8ai/kosa8-claude-plugin
claude plugin install kosa8@kosa8

Claude Code'u yeniden başlatın (veya /reload-plugins komutunu çalıştırın). kosa8 sunucusunun bağlı olduğunu doğrulamak için /mcp komutunu çalıştırın ve Claude'dan "kosa8 durumunu kontrol etmesini" isteyin.

Ana makine klasörlerini paylaşma

Varsayılan olarak ajanlar, ana makinedeki hiçbir dizini korumalı alana paylaşamaz. Bir proje klasörünü paylaşmalarına izin vermek için sunucuyu --allow-mount DIR (salt okunur) veya --allow-mount DIR:rw ile başlatın. Bunu, örneğin bir projenin .mcp.json dosyasına kendi MCP sunucu girdinizi ekleyerek yapabilirsiniz:

{
  "mcpServers": {
    "kosa8-workspace": {
      "command": "kosa8",
      "args": ["mcp", "serve", "--allow-mount", "/Users/you/code/api:rw"]
    }
  }
}

Ağ ve anahtarlar

Bir korumalı alanın ağ erişimi oluşturulurken belirlenir. Bir korumalı alana yalnızca tek bir API'ye erişim vermek ve başka hiçbir şeye erişim vermemek için onu terminalinizden oluşturun:

kosa8 sandbox create sealed --egress-allow api.anthropic.com

Araçlar

kosa8 mcp serve, kosa8 0.5.0'da kosa8 mcp tools tarafından bildirildiği üzere şu araçları sunar:

Araç	Ne işe yarar
kosa8_status	kosa8 arka plan hizmetinin çalışıp çalışmadığını kontrol eder ve sürümünü bildirir
sandbox_create	Kendi çekirdeği ve kapsayıcı motoru olan yalıtılmış bir microVM korumalı alanı başlatır
sandbox_list	Hangi üst öğeden çatallandıkları da dahil olmak üzere korumalı alanları listeler
sandbox_run	Ana makineden yalıtılmış, korumalı alanın özel motorunda bir kapsayıcı çalıştırır
sandbox_pull	Bir görüntüyü korumalı alanın özel motoruna çeker
sandbox_checkpoint	Bellek ve çalışan süreçler dahil bir geri yükleme noktası kaydeder
sandbox_checkpoint_list	Bir korumalı alanın geri yükleme noktalarını listeler
sandbox_rewind	Süreçleri sürdürerek korumalı alanı bir kontrol noktasına geri alır
sandbox_fork	Çalışan bir korumalı alanı N bağımsız kopyaya çatallar
sandbox_explore	En iyiyi seçer: her aday komut için bir kez çatallar, komutları eşzamanlı çalıştırır ve kazananı tutar
sandbox_snapshot	Bir korumalı alanın tüm durumunu anlık görüntü olarak yakalar
sandbox_stop	Bir korumalı alanı silmeden durdurur
sandbox_start	Durdurulmuş bir korumalı alanı kendi diskinden başlatır
sandbox_delete	Bir korumalı alanı ve VM'sini durdurup siler
snapshot_list	Kaydedilmiş korumalı alan anlık görüntülerini listeler
snapshot_restore	Süreçlerini sürdürerek bir anlık görüntüden korumalı alan başlatır
snapshot_rm	Bir anlık görüntüyü siler
container_run	Bir kapsayıcıyı tamamlanana kadar çalıştırır ve çıktısını döndürür
container_exec	Çalışan bir kapsayıcının içinde komut çalıştırır
container_list	Kapsayıcıları listeler
container_logs	Bir kapsayıcının çıktısını getirir
container_stats	Bir kapsayıcının CPU, bellek ve pid kullanımını bildirir
container_stop	Çalışan bir kapsayıcıyı durdurur
image_build	Bir ana makine dizinindeki Dockerfile'dan görüntü oluşturur
image_list	Görüntüleri listeler
image_pull	Bir görüntüyü kayıt defterinden çeker
network_create	Yalıtılmış bir köprü ağı oluşturur
network_list	Kapsayıcı ağlarını listeler
volume_create	Adlandırılmış bir birim oluşturur
volume_list	Adlandırılmış birimleri listeler

Yüklü sürümünüzdeki listeyi görmek için kosa8 mcp tools komutunu çalıştırın.

Bu eklentinin çalıştırdıkları

Eklentinin tek çalıştırılabilir dosyası scripts/kosa8-mcp'dir. Bu kısa kabuk betiği, makinenizde önceden yüklü olan kosa8'i bulur ve kosa8 mcp serve komutunu çalıştırır. Hiçbir şey indirmez veya yüklemez. Eklentinin kendisi hiçbir yere veri göndermez, hiçbir sunucuyla iletişim kurmaz ve kimlik bilgilerini okumaz.

Diğer MCP istemcileri

Aynı sunucu, resmî MCP Kayıt Defteri'nde io.github.kosa8ai/kosa8 olarak yayımlanmıştır (bkz. server.json). Her GitHub sürümüne eklenen bir MCP paketi olan kosa8-mcp.mcpb olarak dağıtılır: bir bildirim dosyası ve scripts/kosa8-mcp ile aynı kısa başlatıcı. Hiçbir şey indirmez veya yüklemez; bu nedenle önce kosa8'i yükleyin.

stdio sunucusu başlatabilen herhangi bir MCP istemcisi kosa8 mcp serve komutunu doğrudan da çalıştırabilir.

Gizlilik

kosa8 MCP sunucusu yerel olarak çalışır ve aynı makinedeki kosa8 arka plan hizmetiyle iletişim kurar. kosa8 gizlilik politikası uyarınca, ajanınızın yaptığı araç çağrıları, bu çağrıların bağımsız değişkenleri ve sonuçları makinenizde kalır ve kosa8'e asla ulaşmaz. Politikada, ücretli lisanslar için lisans kontrolleri de dahil olmak üzere kosa8 yazılımının gönderdiği tüm veriler ve bunların ne zaman gönderildiği, ayrıca KOSA8_OFFLINE=1 ile tüm giden çağrıların nasıl kapatılacağı listelenir.

Politikanın tamamı: https://kosa8.com/privacy/

Fiyatlandırma

kosa8 ticari bir yazılımdır. Bu depodaki eklenti dosyaları ücretsizdir ve MIT lisanslıdır; ancak kosa8'in kendisi lisans gerektirir. Her özellik dahil, hesap ve kart gerektirmeyen 14 günlük ücretsiz deneme sürümüyle gelir. Planlar aylık 29 $'dan başlar. Bkz. https://kosa8.com/pricing/.

Destek ve iletişim

• E-posta: contact@kosa8.com
• Sorunlar: https://github.com/kosa8ai/kosa8-claude-plugin/issues
• Web sitesi: https://kosa8.com

Lisans

Bu depodaki dosyalar MIT Lisansı kapsamında yayımlanır. Lisans yalnızca bu depodaki dosyaları (Claude Code eklentisinin bildirimi, pazar yeri dosyası, MCP yapılandırması, becerisi, komutları, ajanları, başlatıcısı, README'si ve logosu) kapsar. Ayrı olarak kendi koşulları kapsamında dağıtılan ticari yazılım kosa8'in kendisini kapsamaz.