kosa8

plugin kosa8 untuk Claude Code

kosa8: Infrastruktur aman untuk agen AI.

Berikan Claude mesin tersegel untuk bekerja. Plugin ini menghubungkan Claude Code ke kosa8, infrastruktur aman untuk agen AI: setiap agen mendapatkan mesin tersegelnya sendiri, microVM sungguhan dengan kernelnya sendiri, bukan kontainer yang berbagi kernel host.

Dengan plugin ini diaktifkan, Claude dapat:

• menjalankan kode yang tidak tepercaya atau ditulis agen di microVM tersegel yang hanya melihat satu folder (ruang kerja) dan tidak melihat apa pun lainnya di host;
• bekerja di balik jaringan tertutup, tempat hanya host dalam daftar izin yang Anda tulis yang dapat dijangkau dan koneksi lainnya ditolak;
• menggunakan kunci API tanpa menyimpannya: broker egress di host menyisipkannya saat data keluar, dan sandbox hanya menyimpan placeholder;
• membuat checkpoint seluruh mesin yang sedang berjalan, termasuk memori dan proses, dalam sekitar 0,7 detik sebelum langkah berisiko, lalu memulihkannya, tetap berjalan, dalam sekitar satu detik jika terjadi masalah;
• menggandakan mesin yang sedang berjalan menjadi salinan aktif untuk mencoba pendekatan secara paralel dan mempertahankan yang berhasil;
• menunggu persetujuan dari satu atau dua pemberi persetujuan manusia yang disebutkan namanya untuk tindakan berisiko (aturan dua orang), dengan setiap tindakan dicatat dalam log audit berantai hash yang menunjukkan jika ada perubahan.

Plugin ini memiliki empat bagian:

• Server MCP (.mcp.json) yang menjalankan kosa8 mcp serve melalui scripts/kosa8-mcp sebagai proses stdio lokal.
• Skill (skills/kosa8-sandbox) yang memberi tahu Claude kapan harus menggunakan sandbox dan cara menggunakan checkpoint, pemulihan, fork, daftar izin egress, dan persetujuan dengan aman.
• Perintah: /kosa8:status, /kosa8:sandbox <task>, /kosa8:checkpoint, /kosa8:rewind (meminta persetujuan sebelum memulihkan) dan /kosa8:explore (mencoba beberapa perintah dalam fork paralel).
• Agen: sandbox-runner menjalankan kode yang tidak tepercaya atau dihasilkan di microVM tersegel dan melaporkan tindakannya; fork-explorer membandingkan pendekatan dalam fork paralel dari satu sandbox yang sedang berjalan.

Prasyarat

• Claude Code.
• kosa8 terpasang di mesin yang sama, dengan kosa8 di PATH Anda. kosa8 berjalan di Mac dengan chip Apple dan Linux x86-64, serta di Windows melalui WSL2 (pratinjau). Instal dari kosa8.com/download. Rilis ditandatangani dan dinotariskan. Periksa instalasi dengan kosa8 version.
• Daemon kosa8 sedang berjalan. Plugin ini hanya peluncur tipis: sandbox adalah microVM yang dijalankan oleh kosa8d di mesin Anda, jadi tidak ada yang berfungsi sampai daemon aktif.

Sebelum memulai: instal kosa8 dan jalankan daemon

Plugin ini tidak menginstal kosa8 dan tidak dapat berjalan tanpanya. Di mesin baru:

# 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

Jika kosa8 version melaporkan kosa8 daemon: not running, jalankan kosa8 daemon start lagi. Server MCP dapat dimulai tanpa daemon, tetapi setiap alat sandbox akan menjawab cannot reach kosa8d.

Agen yang menginstal server ini untuk pengguna dapat mengikuti llms-install.md.

Instalasi

Di Claude Code, tambahkan repositori ini sebagai marketplace dan instal plugin:

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

Atau dari shell Anda:

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

Mulai ulang Claude Code (atau jalankan /reload-plugins). Jalankan /mcp untuk memastikan server kosa8 terhubung, lalu minta Claude untuk "memeriksa status kosa8".

Berbagi folder host

Secara default, agen tidak dapat membagikan direktori host apa pun ke dalam sandbox. Agar mereka dapat membagikan folder proyek, jalankan server dengan --allow-mount DIR (hanya baca) atau --allow-mount DIR:rw. Anda dapat melakukannya dengan menambahkan entri server MCP sendiri, misalnya di .mcp.json milik proyek:

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

Jaringan dan kunci

Akses jaringan untuk sandbox ditetapkan saat sandbox dibuat. Untuk memberi sandbox akses ke satu API saja, buat sandbox dari terminal Anda:

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

Alat

kosa8 mcp serve menyediakan alat-alat berikut (seperti yang dilaporkan oleh kosa8 mcp tools di kosa8 0.5.0):

Alat	Fungsinya
kosa8_status	Memeriksa apakah daemon kosa8 sedang berjalan dan melaporkan versinya
sandbox_create	Menjalankan microVM terisolasi dengan kernel dan mesin kontainernya sendiri
sandbox_list	Mencantumkan sandbox, termasuk asal induk setiap fork
sandbox_run	Menjalankan kontainer di dalam mesin privat sandbox, terisolasi dari host
sandbox_pull	Mengambil image ke dalam mesin privat sandbox
sandbox_checkpoint	Menyimpan titik pemulihan, termasuk memori dan proses yang sedang berjalan
sandbox_checkpoint_list	Mencantumkan titik pemulihan sandbox
sandbox_rewind	Mengembalikan sandbox ke checkpoint, dengan proses dilanjutkan
sandbox_fork	Menggandakan sandbox yang sedang berjalan menjadi N salinan independen
sandbox_explore	Best-of-N: membuat satu fork untuk setiap kandidat perintah, menjalankannya secara bersamaan, lalu mempertahankan yang terbaik
sandbox_snapshot	Mengambil seluruh status sandbox sebagai snapshot
sandbox_stop	Menghentikan sandbox tanpa menghapusnya
sandbox_start	Memulai sandbox yang dihentikan dari disknya sendiri
sandbox_delete	Menghentikan dan menghapus sandbox beserta VM-nya
snapshot_list	Mencantumkan snapshot sandbox yang tersimpan
snapshot_restore	Menjalankan sandbox dari snapshot, dengan proses dilanjutkan
snapshot_rm	Menghapus snapshot
container_run	Menjalankan kontainer hingga selesai dan mengembalikan output-nya
container_exec	Menjalankan perintah di dalam kontainer yang sedang berjalan
container_list	Mencantumkan kontainer
container_logs	Mengambil output kontainer
container_stats	Melaporkan penggunaan CPU, memori, dan pid untuk kontainer
container_stop	Menghentikan kontainer yang sedang berjalan
image_build	Membuat image dari Dockerfile di direktori host
image_list	Mencantumkan image
image_pull	Mengambil image dari registry
network_create	Membuat jaringan bridge terisolasi
network_list	Mencantumkan jaringan kontainer
volume_create	Membuat volume bernama
volume_list	Mencantumkan volume bernama

Jalankan kosa8 mcp tools untuk melihat daftar alat pada versi yang Anda instal.

Yang dijalankan plugin ini

Satu-satunya file yang dapat dieksekusi milik plugin adalah scripts/kosa8-mcp, skrip shell singkat yang menemukan kosa8 yang sudah terpasang di mesin Anda dan menjalankan kosa8 mcp serve. Skrip ini tidak mengunduh atau menginstal apa pun. Plugin itu sendiri tidak mengirim data ke mana pun, tidak menghubungi server, dan tidak membaca kredensial.

Klien MCP lainnya

Server yang sama terdaftar di Registry MCP resmi sebagai io.github.kosa8ai/kosa8 (lihat server.json). Server ini didistribusikan sebagai bundel MCP, kosa8-mcp.mcpb, yang dilampirkan pada setiap rilis GitHub: sebuah manifest dan peluncur singkat yang sama dengan scripts/kosa8-mcp. Server ini tidak mengunduh atau menginstal apa pun, jadi instal kosa8 terlebih dahulu.

Klien MCP apa pun yang dapat memulai server stdio juga dapat menjalankan kosa8 mcp serve secara langsung.

Privasi

Server MCP kosa8 berjalan secara lokal dan berkomunikasi dengan daemon kosa8 di mesin yang sama. Berdasarkan kebijakan privasi kosa8, pemanggilan alat yang dilakukan agen Anda, argumennya, dan hasilnya tetap berada di mesin Anda dan tidak pernah sampai ke kosa8. Kebijakan tersebut mencantumkan semua hal yang dikirim perangkat lunak kosa8 dan kapan pengiriman dilakukan, termasuk pemeriksaan lisensi untuk lisensi berbayar, serta cara menonaktifkan semua panggilan keluar dengan KOSA8_OFFLINE=1.

Kebijakan lengkap: https://kosa8.com/privacy/

Harga

kosa8 adalah perangkat lunak komersial. Berkas plugin di repositori ini gratis dan berlisensi MIT, tetapi kosa8 sendiri memerlukan lisensi: tersedia uji coba gratis selama 14 hari dengan semua fitur, tanpa akun dan tanpa kartu. Paket mulai dari $29 per bulan. Lihat https://kosa8.com/pricing/.

Dukungan dan kontak

• Email: contact@kosa8.com
• Isu: https://github.com/kosa8ai/kosa8-claude-plugin/issues
• Situs web: https://kosa8.com

Lisensi

Berkas di repositori ini dirilis berdasarkan Lisensi MIT. Lisensi ini hanya mencakup berkas di repositori ini (plugin Claude Code: manifest, berkas marketplace, konfigurasi MCP, skill, perintah, agen, peluncur, README, dan logo). Lisensi ini tidak mencakup perangkat lunak kosa8 itu sendiri, yang merupakan perangkat lunak komersial dan didistribusikan secara terpisah berdasarkan ketentuannya sendiri.