
CLI فائق السرعة على Apple Silicon macOS لتطوير سريع ومعزول وعوامل LLM.
صندوق رمل (sandbox) فائق السرعة مفتوح المصدر لتشغيل وكلاء البرمجة بأمان.
VibeBox هو صندوق رمل صغير-VM لكل مشروع لتشغيل وكلاء البرمجة على macOS (إطار عمل المحاكاة الافتراضية من Apple). إنه محسّن لسير عمل الاستخدام اليومي: إعادة دخول سريعة دافئة، ووحدات تحميل صريحة، وجلسات قابلة لإعادة الاستخدام.
لمن هذا: مستخدمو macOS الذين يشغلون وكلاء البرمجة ويريدون عزلًا حقيقيًا دون التخلي عن سير عمل يومي سريع.
حقائق سريعة: إعادة الدخول الدافئة عادةً ما تكون <5 ثوانٍ على جهاز M3 الخاص بي (تختلف حسب الجهاز/ذاكرة التخزين المؤقت)؛ التشغيل الأول يقوم بتحميل وتجهيز صورة أساسية من Debian (تعتمد على الشبكة).
نموذج الأمان: ضيف VM لنظام Linux مع قوائم السماح للتحميل الصريح من vibebox.toml (المستودع أولاً، كل شيء آخر اختياري).
vibebox يلقي بك في صندوق رمل قابل لإعادة الاستخدام للمستودع الحالي# من أي مستودع
cd my-project
vibebox
ما يجب أن تراه (تقريبًا):
vibebox: starting (session: my-project)
vibebox: attaching...
vibecoder@vibebox:~/my-project$
أستخدم وكلاء البرمجة يوميًا، وأردت منحهم شيل حقيقي دون تسليم جهازي المضيف. إذا قفلت الأمور، تحصل على تأكيدات لا تنتهي؛ إذا خففت القيود، تقلق بشأن حذف الملفات، لمس الأسرار، أو التجوال خارج المستودع.
VibeBox هو الوسط: صندوق رمل لكل مستودع مع حد VM صلب، إعادة دخول سريعة، وتحميلات صريحة. إنه مبني ليكون "دائم التشغيل" لعمل الوكلاء دون جعل السلامة واجبًا مزعجًا.
الحاويات رائعة. VibeBox لا يحاول استبدال Docker/devcontainers لبناء الخدمات.
أردت تحديدًا افتراض VM لسير عمل الوكلاء على macOS:
إليك لماذا لم أستخدم الخيارات الموجودة فقط:
هذا ما دفعني لبناء VibeBox: أردت صندوق رمل لكل مشروع يكون سريع الدخول (فقط vibebox)، يدعم التكوين الحقيقي + الجلسات، ويحافظ على حد عزل صلب.
# script التثبيت
curl -fsSL https://raw.githubusercontent.com/robcholz/vibebox/main/install | bash
# مدير الحزم
cargo install vibebox
# التثبيت اليدوي
curl -LO https://github.com/robcholz/vibebox/releases/download/latest/vibebox-macos-arm64.zip
unzip vibebox-macos-arm64.zip
mkdir -p ~/.local/bin
mv vibebox ~/.local/bin
export PATH="$HOME/.local/bin:$PATH"
المتطلبات
التشغيل الأول
يقوم أول تشغيل لـ vibebox بتحميل صورة أساسية من Debian وتجهيزها. بعد ذلك، تستخدم حالات كل مشروع الصورة الأساسية المخبأة لبدايات أسرع بكثير.
بداية سريعة
cd /path/to/your/project
vibebox
في التشغيل الأول، ينشئ VibeBox vibebox.toml في مشروعك (إذا كان مفقودًا) ودليل .vibebox/ لبيانات الحالة.
الإعداد (vibebox.toml)
يعيش vibebox.toml في جذر مشروعك افتراضيًا. يمكنك تجاوزه باستخدام vibebox -c path/to/vibebox.toml أو متغير البيئة VIBEBOX_CONFIG_PATH، لكن المسار يجب أن يبقى داخل دليل المشروع.
الإعداد الافتراضي (يتم إنشاؤه تلقائيًا عند فقدانه):
[box]
cpu_count = 2
ram_mb = 2048
disk_gb = 5
mounts = [
"~/.codex:~/.codex:read-write",
"~/.claude:~/.claude:read-write",
]
[supervisor]
auto_shutdown_ms = 20000
disk_gb يتم تطبيقه فقط عند إنشاء قرص الحالة لأول مرة. إذا قمت بتغييره لاحقًا، قم بتشغيل vibebox reset لإعادة إنشاء القرص.
التحميلات
~/<project-name>، ويبدأ الشيل هناك..git موجودًا، يتم إخفاؤه باستخدام تحميل tmpfs داخل VM لتثبيط التعديلات العرضية من الضيف.box.mounts بالصيغة host:guest[:read-only|read-write].~. يتم التعامل مع مسارات الضيف النسبية كـ /root/<path>.~ مرتبطة بـ /home/<ssh-user> للراحة. قم بتشغيل vibebox explain لرؤية تعيينات المضيف/الضيف المحلولة.أوامر CLI
vibebox # بدء أو الإرفاق بـ VM المشروع الحالي
vibebox list # عرض جلسات المشروع المعروفة
vibebox reset # حذف .vibebox لهذا المشروع وإعادة إنشائه في التشغيل التالي
vibebox purge-cache # حذف الذاكرة المؤقتة العامة (~/.cache/vibebox)
vibebox explain # عرض معلومات التحميلات والشبكة
داخل VM
vibecodervibeboxgit، curl، ripgrep، openssh-server، و sudo.mise وتكوين أدوات مثل uv، node، @openai/codex، و @anthropic-ai/claude-code (أفضل جهد).:help و :exit.الحالة والذاكرة المؤقتة
.vibebox/ (قرص الحالة، مفاتيح SSH، السجلات، مقبس/معرف عملية المدير). vibebox reset يزيلها.~/.cache/vibebox (الصورة الأساسية + ذاكرة الضيف المشتركة). vibebox purge-cache يمسحها.~/.vibebox/sessions ويظهر بواسطة vibebox list.إذا كنت مهتمًا بالمساهمة في VibeBox، يرجى قراءة وثائق المساهمة قبل تقديم طلب سحب.
VibeBox مبني لصناديق رمل محلية سريعة وقابلة للتكرار مع أقل قدر من المراسم. ما يختلف هنا:
vibebox — يلقيك في الصندوق الرمل من مشروعك.vibebox.toml، حيث يمكنك تعيين CPU، RAM، حجم القرص، والتحميلات.vibe من قبل lynaghk.
ومجتمع Rust الرائع — بدون النظام البيئي وأدوات مثل crates.io، لم يكن هذا ممكنًا!
تابعني على X x.com/robcholz