agent-run
Jalankan agen AI dalam lingkungan sandbox menggunakan biner mandiri kecil dengan konfigurasi TOML sederhana.
agent-run
Apa itu agent-run?
agent-run adalah alat baris perintah yang menjalankan agen coding AI (seperti pi, opencode, codex, claude) dalam lingkungan sandbox menggunakan bubblewrap. Alat ini menyediakan konfigurasi berbasis TOML sederhana untuk mengontrol akses jaringan, variabel lingkungan, dan titik mount, menjaga agen tetap terisolasi dari sistem file host kecuali untuk jalur yang ditentukan.
Cara menggunakan agent-run?
- 1Instal melalui Nix: nix run github:sin-ack/agent-run -- <command>
- 2Atau melalui Mise: mise use github:sin-ack/agent-run@latest
- 3Atau manual: unduh biner dari rilis, tempatkan di PATH, chmod +x
- 4Buat file konfigurasi TOML di .agent-run/config.toml (atau gunakan bawaan)
- 5Jalankan: agent-run <agent> (misalnya agent-run claude)
agent-run Fitur utama
- Biner mandiri kecil (<1MB) untuk GNU/Linux (aarch64 dan x86_64)
- Konfigurasi berbasis TOML sederhana dengan dukungan skema JSON
- Eksekusi sandbox melalui bwrap tertanam (namespace pengguna tanpa hak istimewa)
- Mendukung beberapa agen coding: pi, opencode, codex, claude
- Mount, variabel lingkungan, dan akses jaringan yang dapat dikonfigurasi per alat
- Sistem file host hanya-baca secara bawaan dengan mount yang dapat ditulis opsional
agent-run Contoh penggunaan
- Jalankan agen coding AI dengan aman tanpa prompt izin
- Isolasi agen dari file non-proyek untuk mencegah kerusakan tidak disengaja
- Uji atau kembangkan agen dalam lingkungan yang terkendali
- Sandbox operasi agen sambil mengizinkan akses ke direktori tertentu
agent-run Harga dan kredit gratis
agent-run menggunakan model Gratis.
Alat ini sepenuhnya gratis
agent-run Kelebihan dan kekurangan
Kelebihan
- Sangat ringan dan cepat
- Konfigurasi sederhana dengan bawaan yang baik
- Fleksibilitas per alat untuk mount, env, jaringan
- Sumber terbuka dan dapat diaudit
Kekurangan
- Hanya Linux (membutuhkan bwrap dan namespace pengguna tanpa hak istimewa)
- Tidak diperkeras terhadap kode berbahaya (sistem file hanya-baca tetapi soket/jaringan tersedia)
- Terbatas pada agen yang didukung; agen kustom memerlukan konfigurasi manual
- Tidak ada dukungan overlay atau agen paralel
agent-run paling cocok untuk apa?
- Pengembang yang menggunakan agen coding AI
- Mereka yang menginginkan sandbox sederhana tanpa VM berat
- Pengguna yang terganggu oleh prompt izin
- Pengguna Linux yang mencari alat isolasi ringan