agent-run
Führen Sie einen Codierungsagenten in einer sandboxierten Umgebung mit einer winzigen eigenständigen Binärdatei und einfacher TOML-Konfiguration aus.
agent-run
Was ist agent-run?
agent-run ist ein Befehlszeilentool, das KI-Codierungsagenten (wie pi, opencode, codex, claude) in einer sandboxierten Umgebung mit Bubblewrap ausführt. Es bietet eine einfache TOML-basierte Konfiguration zur Steuerung des Netzwerkzugriffs, der Umgebungsvariablen und der Einhängepunkte und hält die Agenten bis auf angegebene Pfade vom Host-Dateisystem isoliert.
So nutzt du agent-run?
- 1Installation via Nix: nix run github:sin-ack/agent-run -- <Befehl>
- 2Oder via Mise: mise use github:sin-ack/agent-run@latest
- 3Oder manuell: Binärdatei aus Releases herunterladen, in PATH platzieren, chmod +x
- 4Erstellen Sie eine TOML-Konfigurationsdatei unter .agent-run/config.toml (oder verwenden Sie die Standardeinstellung)
- 5Ausführen: agent-run <Agent> (z. B. agent-run claude)
agent-run Wichtige Funktionen
- Winzige eigenständige Binärdatei (<1 MB) für GNU/Linux (aarch64 und x86_64)
- Einfache TOML-basierte Konfiguration mit JSON-Schema-Unterstützung
- Sandboxierte Ausführung über eingebettetes bwrap (unprivilegierte Benutzernamensräume)
- Unterstützt mehrere Codierungsagenten: pi, opencode, codex, claude
- Pro-Tool konfigurierbare Einhängepunkte, Umgebungsvariablen und Netzwerkzugriff
- Schreibgeschütztes Host-Dateisystem standardmäßig mit optionalen beschreibbaren Einhängepunkten
agent-run Anwendungsfälle
- KI-Codierungsagenten sicher ausführen, ohne Berechtigungsabfragen
- Agenten von Nicht-Projektdateien isolieren, um versehentliche Schäden zu vermeiden
- Agenten in einer kontrollierten Umgebung testen oder entwickeln
- Agentenoperationen in einer Sandbox ausführen, während Zugriff auf bestimmte Verzeichnisse erlaubt wird
agent-run Preise und Gratis-Credits
agent-run arbeitet mit dem Modell Kostenlos.
agent-run Vorteile und Nachteile
Vorteile
- Extrem leichtgewichtig und schnell
- Einfache Konfiguration mit guten Standardeinstellungen
- Pro-Tool Flexibilität für Einhängepunkte, Umgebungsvariablen, Netzwerk
- Open Source und überprüfbar
Nachteile
- Nur Linux (erfordert bwrap und unprivilegierte Benutzernamensräume)
- Nicht gegen bösartigen Code gehärtet (schreibgeschütztes Dateisystem, aber Sockets/Netzwerk verfügbar)
- Auf unterstützte Agenten beschränkt; benutzerdefinierte Agenten erfordern manuelle Konfiguration
- Keine Overlay- oder parallele Agentenunterstützung
Wofür eignet sich agent-run am besten?
- Entwickler, die KI-Codierungsagenten verwenden
- Diejenigen, die eine einfache Sandboxierung ohne schwere VMs wünschen
- Benutzer, die von Berechtigungsabfragen genervt sind
- Linux-Benutzer, die ein leichtgewichtiges Isolationswerkzeug suchen