agent-run
تشغيل وكيل برمجة في بيئة معزولة باستخدام ملف ثنائي صغير مستقل مع إعدادات TOML بسيطة.
agent-run
ما هو agent-run؟
agent-run هي أداة سطر أوامر تقوم بتشغيل وكلاء البرمجة الذكية (مثل pi، opencode، codex، claude) في بيئة معزولة باستخدام bubblewrap. توفر إعدادات بسيطة قائمة على TOML للتحكم في الوصول إلى الشبكة ومتغيرات البيئة ونقاط التثبيت، مما يحافظ على عزل الوكلاء عن نظام الملفات المضيف باستثناء المسارات المحددة.
طريقة استخدام agent-run
- 1التثبيت عبر Nix: nix run github:sin-ack/agent-run -- <command>
- 2أو عبر Mise: mise use github:sin-ack/agent-run@latest
- 3أو يدويًا: تحميل الملف الثنائي من الإصدارات، وضعه في PATH، chmod +x
- 4إنشاء ملف إعدادات TOML في .agent-run/config.toml (أو استخدام الافتراضي)
- 5التشغيل: agent-run <agent> (مثال: agent-run claude)
الميزات الرئيسية في agent-run
- ملف ثنائي صغير مستقل (<1 ميغابايت) لنظام GNU/Linux (aarch64 و x86_64)
- إعدادات بسيطة قائمة على TOML مع دعم مخطط JSON
- تنفيذ معزول عبر bwrap المضمن (مساحات أسماء مستخدم غير مميزة)
- يدعم وكلاء برمجة متعددين: pi، opencode، codex، claude
- إعدادات قابلة للتكوين لكل أداة لنقاط التثبيت ومتغيرات البيئة والوصول إلى الشبكة
- نظام ملفات مضيف للقراءة فقط افتراضيًا مع نقاط تثبيت قابلة للكتابة اختيارياً
حالات استخدام agent-run
- تشغيل وكلاء البرمجة الذكية بأمان دون طلبات إذن
- عزل الوكلاء عن ملفات غير المشروع لمنع الضرر العرضي
- اختبار أو تطوير الوكلاء في بيئة خاضعة للتحكم
- عزل عمليات الوكلاء مع السماح بالوصول إلى أدلة محددة
أسعار agent-run والأرصدة المجانية
يعمل agent-run بنموذج مجاني.
مزايا وعيوب agent-run
المزايا
- خفيف الوزن للغاية وسريع
- إعدادات بسيطة مع إعدادات افتراضية جيدة
- مرونة لكل أداة للتثبيت والبيئة والشبكة
- مفتوح المصدر وقابل للتدقيق
العيوب
- لنظام Linux فقط (يتطلب bwrap ومساحات أسماء مستخدم غير مميزة)
- غير محصن ضد البرامج الضارة (نظام ملفات للقراءة فقط ولكن المقابس/الشبكة متاحة)
- مقتصر على الوكلاء المدعومين؛ يتطلب الوكلاء المخصصون إعدادات يدوية
- لا يوجد دعم للتراكب أو الوكلاء المتوازيين
لأي استخدام يناسب agent-run أكثر؟
- المطورين الذين يستخدمون وكلاء البرمجة الذكية
- من يريدون عزلًا بسيطًا دون أجهزة افتراضية ثقيلة
- المستخدمون المنزعجون من طلبات الإذن
- مستخدمو Linux الذين يبحثون عن أداة عزل خفيفة الوزن