agent-run
Küçük bağımsız bir ikili dosya ve basit TOML yapılandırması kullanarak bir kodlama aracısını kum havuzu ortamında çalıştırın.
agent-run
Nedir agent-run?
agent-run, AI kodlama aracılarını (pi, opencode, codex, claude gibi) bubblewrap kullanarak kum havuzu ortamında çalıştıran bir komut satırı aracıdır. Ağ erişimini, ortam değişkenlerini ve bağlama noktalarını kontrol etmek için basit TOML tabanlı yapılandırma sağlar; aracıları, belirtilen yollar dışında ana dosya sisteminden izole eder.
Nasıl kullanılır agent-run?
- 1Nix ile kurulum: nix run github:sin-ack/agent-run -- <komut>
- 2Veya Mise ile: mise use github:sin-ack/agent-run@latest
- 3Veya manuel: sürümlerden ikili dosyayı indirin, PATH'e koyun, chmod +x yapın.
- 4.agent-run/config.toml yolunda bir TOML yapılandırma dosyası oluşturun (veya varsayılanı kullanın)
- 5Çalıştırma: agent-run <aracı> (ör. agent-run claude)
agent-run Temel özellikler
- GNU/Linux için küçük bağımsız ikili dosya (<1MB) (aarch64 ve x86_64)
- JSON şeması desteğiyle basit TOML tabanlı yapılandırma
- Gömülü bwrap ile kum havuzunda çalıştırma (ayrıcalıksız kullanıcı ad alanları)
- Birden çok kodlama aracısını destekler: pi, opencode, codex, claude
- Araç başına yapılandırılabilir bağlama noktaları, ortam değişkenleri ve ağ erişimi
- Varsayılan olarak salt okunur ana dosya sistemi, isteğe bağlı yazılabilir bağlama noktaları
agent-run Kullanım senaryoları
- AI kodlama aracılarını izin istemleri olmadan güvenli bir şekilde çalıştırma
- Aracıları proje dışı dosyalardan izole ederek kazara hasarı önleme
- Kontrollü bir ortamda aracıları test etme veya geliştirme
- Aracı işlemlerini kum havuzuna alırken belirli dizinlere erişime izin verme
agent-run Fiyatlar ve ücretsiz krediler
agent-run, Ücretsiz modeliyle çalışır.
agent-run Artılar ve eksiler
Artılar
- Son derece hafif ve hızlı
- İyi varsayılanlarla basit yapılandırma
- Bağlama, ortam, ağ için araç başına esneklik
- Açık kaynak ve denetlenebilir
Eksiler
- Yalnızca Linux (bwrap ve ayrıcalıksız kullanıcı ad alanları gerektirir)
- Kötü amaçlı koda karşı korumalı değil (salt okunur dosya sistemi ancak soketler/ağ mevcut)
- Yalnızca desteklenen aracılarla sınırlı; özel aracılar manuel yapılandırma gerektirir
- Bindirme veya paralel aracı desteği yok
agent-run en çok ne için uygundur?
- AI kodlama aracıları kullanan geliştiriciler
- Ağır VM'ler olmadan basit kum havuzu isteyenler
- İzin istemlerinden rahatsız olan kullanıcılar
- Hafif bir izolasyon aracı arayan Linux kullanıcıları