
دع ذكاءك الاصطناعي ينطلق بأقصى طاقته. مجلدك الرئيسي يبقى في مكانه.
██╗ ██╗ ██████╗ ██╗ ██████╗ ██████╗ ██████╗ ██╗ ██╗
╚██╗ ██╔╝██╔═══██╗██║ ██╔═══██╗██╔══██╗██╔═══██╗╚██╗██╔╝
╚████╔╝ ██║ ██║██║ ██║ ██║██████╔╝██║ ██║ ╚███╔╝
╚██╔╝ ██║ ██║██║ ██║ ██║██╔══██╗██║ ██║ ██╔██╗
██║ ╚██████╔╝███████╗╚██████╔╝██████╔╝╚██████╔╝██╔╝ ██╗
╚═╝ ╚═════╝ ╚══════╝ ╚═════╝ ╚═════╝ ╚═════╝ ╚═╝ ╚═╝
دع ذكاءك الاصطناعي ينطلق بأقصى قوة. يبقى دليلك الرئيسي في مكانه.
التوثيق: yolobox.dev
سجل التغييرات: CHANGELOG.md
شغّل Claude Code، Codex، Kimi Code، Gemini، Antigravity، OpenCode، Copilot، Pi، أو أي وكيل برمجة بالذكاء الاصطناعي في "وضع yolo" دون تدمير دليلك الرئيسي.
وكلاء البرمجة بالذكاء الاصطناعي أقوياء للغاية عندما تتيح لهم تنفيذ الأوامر دون طلب إذن. لكن بعد أمر واحد أُسيء تفسيره وrm -rf ~، ستكون مضطرًا لاستعادة النسخ الاحتياطي (أجل، كما لو كانت لديك نسخ احتياطية أصلًا).
يشغّل yolobox وكيل الذكاء الاصطناعي الخاص بك داخل حاوية حيث:
/Users/you/projectيمكن للذكاء الاصطناعي أن يتحرر تمامًا داخل بيئة العزل. أما دليلك الرئيسي الفعلي؟ لا يمكن المساس به.
# Install via Homebrew
brew install finbarr/tap/yolobox
# Or install via script
curl -fsSL https://raw.githubusercontent.com/finbarr/yolobox/master/install.sh | bash
Homebrew يثبّت إكمالات bash وzsh تلقائيًا. بالنسبة لتثبيتات السكربت، راجع إكمالات الصدفة.
ثم من أي مشروع:
cd /path/to/your/project
yolobox claude # Let it rip
تعمل اختصارات الذكاء الاصطناعي الأخرى بالطريقة نفسها:
yolobox codex
yolobox gemini
yolobox kimi
yolobox agy
yolobox antigravity
yolobox opencode
yolobox copilot
yolobox pi
عيّن default_harness = "codex" لجعل yolobox المجرّد يشغّل Codex. استخدم yolobox shell عندما تريد صدفة يدوية، وyolobox run <cmd...> عندما تريد أمرًا واحدًا داخل بيئة العزل.
توجد تفاصيل التثبيت والتشغيل الكاملة في Installation & Setup. وتوجد أمثلة الأوامر في Commands.
تأتي الصورة الأساسية مع واجهات سطر أوامر الذكاء الاصطناعي (AI CLIs)، ومحوّلات Codex وClaude ACP، وNode.js، وPython، وGo، وBun، وأدوات البناء، وGit، وGitHub CLI، وripgrep، وfd، وfzf، وjq، وvim، وRTK، والأدوات العملية المعتادة.
هل تحتاج إلى شيء آخر؟ يمتلك الوكيل صلاحيات sudo.
داخل yolobox، تُغلَّف واجهات سطر أوامر الذكاء الاصطناعي المدعومة لتتجاوز مطالبات الأذونات. لا تأكيدات، ولا حواجز حماية. مجرد ذكاء اصطناعي خالص غير مُفلتر، كما تقتضي الطبيعة.
بالنسبة لعميل ACP أو محرر، استخدم yolobox run codex-acp أو yolobox run claude-agent-acp كأمر وكيل stdio الخاص به. تُضمّن المحوّلات محركات متوافقة وتستخدم أنماط الأذونات الخاصة بالعميل؛ ولا تتحكم بها أغلفة YOLO الخاصة بواجهة سطر أوامر yolobox ولا --no-yolo. تنطبق خيارات مزامنة الإعدادات والمصادقة الحالية. راجع ACP clients لأمثلة التشغيل.
يذهب تقدّم سحب الصورة وبناء الصورة المخصصة إلى stderr، تاركًا stdout وstdin الموجّه عبر الأنابيب لأمر الحاوية، بما في ذلك أثناء بدء تشغيل ACP.
للاطلاع على قائمة الأدوات الكاملة، وجدول أغلفة وضع YOLO، وملاحظات RTK، وسياسة حداثة حزم npm، وسلوك ترقية واجهات سطر الأوامر المضمّنة، راجع What's in the Box.
إذا كان مشروع واحد يحتاج إلى أدوات إضافية أو متغيرات بيئة، فأضف إعدادًا صغيرًا للمشروع بدلًا من تفرّع الصورة الأساسية بأكملها:
# .yolobox.toml
env = ["CODEX_HOME=/home/yolo/.codex-account"]
[customize]
packages = ["default-jdk", "maven"]
ثم شغّله بشكل عادي:
yolobox run mvn --version
يمكن أن تضيف التخصيصات على مستوى المشروع أيضًا جزء Dockerfile فوق الصورة الأساسية. يُنشئ التشغيل الأول صورة مشتقة؛ وتُعاد استخدامها في التشغيلات اللاحقة حتى تتغير الصورة الأساسية أو مدخلات التخصيص.
استخدم مسارات الحاوية لقيم env لأنها تُمرَّر مباشرةً إلى العملية داخل yolobox. تُمرَّر قيم env إلى وقت التشغيل حرفيًا؛ ولا يُفسَّر أي شيء فيها.
لتمرير قيمة مختلفة إلى بيئة العزل (sandbox) عن تلك التي يستخدمها المضيف تحت الاسم نفسه — رمز للقراءة فقط بدلًا من رمزك الحقيقي — اربطها باسم بديل باستخدام env_from_host (أو --env-from-host KEY=HOST_VAR):
# .yolobox.toml
env_from_host = ["GH_TOKEN=YOLOBOX_READONLY_GH_TOKEN"]
الاسم المستعار يملك هذا المتغير: فهو يمنع التمرير التلقائي و--gh-token للمفتاح نفسه، ويرفض yolobox بدء التشغيل إذا كان متغير المضيف غير معيّن، لذا لا يمكن للتوكِن الذي يستبدله أن يتسرب عن طريق الخطأ.
راجع Configuration لإعدادات بيئة المشروع، وProject-Level Customization لتثبيت الحزم، وأجزاء Dockerfile، وسلوك إعادة البناء، وسلوك الترقية، والصور المخصصة بالكامل.
yolobox setup # Configure global defaults
yolobox config # Show resolved config for this project
yolobox claude --docker --gh-token # Give the agent Docker and GitHub access
yolobox claude --claude-config --no-claude-auth # Share config, keep the box login independent
yolobox copilot --copilot-config # Share Copilot settings, login, and session history
yolobox codex --rtk # Enable RTK command-output compression
yolobox run --no-network make test # Run one command with no network
yolobox fork --name bruno codex # Give an agent its own project copy
yolobox upgrade # Update binary and pull the latest image
yolobox update-agents # Update AI CLIs and ACP adapters in the persistent box
yolobox reset --force # Remove yolobox volumes from the configured runtime
يعمل Reset مع Docker وPodman وApple container. فهو يزيل فقط أحجام yolobox الموجودة وينجح عندما لا يتبقى أي منها. كما ينظّف yolobox uninstall --force تلك الأحجام قبل إزالة الملف التنفيذي والإعدادات العامة؛ وأي فشل في وقت التشغيل يوقف إلغاء التثبيت حتى يمكن إعادة المحاولة. أضف --keep-volumes إلى إلغاء التثبيت مع الحفاظ على بيانات وقت التشغيل.
تضمّن الصورة OpenCode v2 (@opencode/cli). كما يثبّت yolobox update-agents opencode الإصدار v2، مع إزالة حزمة opencode-ai القديمة من بادئة npm الدائمة أولًا لتجنّب تعارض المشغّل. تسمح عمليات التثبيت صراحةً بسكربت postinstall المطلوب. تبقى نسخ v1 المثبّتة من قِبل المستخدم في مكانها حتى تقوم بتحديثها؛ وسحب صورة جديدة وحده لا يستبدل الأدوات الدائمة.
يحتفظ OpenCode v2 بأمر opencode ومواقع الإعدادات الحالية. احتفظ بنسخة احتياطية من إعدادك قبل التبديل: تحتاج إضافات v1 وتكاملات واجهة برمجة تطبيقات الخادم إلى الترحيل. راجع دليل الترحيل من المنبع.
يزامن --claude-config بشكل تدريجي إعدادات Claude الدائمة ويُركّب ~/.claude/projects الخاص بالمضيف للقراءة/الكتابة بشكل حي بحيث يبقى سجل استئناف الجلسة محدّثًا. يُبقي --no-claude-auth تسجيل الدخول داخل الصندوق مستقلًا، لكنه لا يجعل تركيب سجل المشروع هذا للقراءة فقط. يفعل --copilot-config الشيء نفسه مع GitHub Copilot CLI: فهو يزامن إعدادات ~/.copilot الدائمة والوكلاء والمهارات وإعداد MCP، ويمرّر تسجيل دخول Copilot الخاص بالمضيف كـ COPILOT_GITHUB_TOKEN، ويُركّب ~/.copilot/session-state للقراءة/الكتابة بشكل حي؛ أضف --no-copilot-auth لإبقاء تسجيل دخول Copilot داخل الصندوق مستقلًا.
يطبّق إعداد RTK التلقائي تكاملات CLI المدعومة دون مطالبة، بما في ذلك عند أول تشغيل لـ OpenCode، ويُبقي القياس عن بُعد معطّلًا ما لم تشترك تفاعليًا من داخل الصندوق باستخدام rtk telemetry enable.
المراجع التفصيلية موجودة عمدًا في موقع التوثيق: