cplt

بيئة معزولة (sandbox) مفروضة على مستوى النواة لوكلاء البرمجة بالذكاء الاصطناعي. يغلّف cplt كلاً من GitHub Copilot CLI وOpenCode وGemini CLI وAntigravity CLI وPi وClaude Code وgoose وDeepSeek Harness أو أي shell، بحيث يستطيع الوكيل كتابة الشيفرة لكنه لا يستطيع سرقة بيانات الاعتماد أو الدفع إلى main أو دمج طلبات السحب (PRs) أو تسريب الأسرار.

• macOS: Apple Seatbelt/SBPL عبر sandbox-exec
• Linux: Landlock LSM + seccomp-BPF + عزل اختياري لنطاقات الأسماء (namespace) عبر Bubblewrap (نواة 5.13+، تصفية شبكة كاملة على 6.7+)
• Windows: لا يوجد دعم أصلي. لا يوجد خلفية sandbox لنظام Windows. شغّل cplt داخل WSL2، حيث يكون تثبيتًا عاديًا على Linux وتوفّر نواة Microsoft وحدة Landlock. راجع إعداد Windows (WSL2).

لماذا cplt؟

ينفّذ وكلاء الذكاء الاصطناعي شيفرة عشوائية. الوكيل المخترق، سواء عبر حقن الأوامر (prompt injection) أو هجوم على سلسلة التوريد أو خادم MCP خبيث، يمكنه قراءة ~/.ssh أو الدفع إلى main أو دمج طلبات السحب أو تسريب شيفرتك، ما لم يقل نظام التشغيل نفسه لا.

يمنحك cplt فرضًا على مستوى النواة مع سياسة قابلة للتهيئة على مستوى الفريق:

• سياسة لكل مستودع في .cplt.toml، مُلتزَمة في نظام التحكم بالإصدارات، بحيث تكون محصّنة ضد التلاعب وقابلة للتدقيق
• الرفض افتراضيًا لبيانات الاعتماد والأسرار والملفات الحساسة
• اعتراض git وgh على مستوى الأوامر: الدفع إلى الفرع الافتراضي والدفع القسري وعمليات الدمج والإصدارات محظورة، بينما تبقى فروع الميزات مفتوحة
• تصفية الشبكة الصادرة مع سجل تدقيق
• لا Docker، لا أجهزة افتراضية. ملف تنفيذي واحد يعمل على حاسوب محمول مُقيَّد
• بدء بدون تهيئة للمطورين، مع مخارج طوارئ عندما يحتاج البناء إليها فعلاً

جدول المحتويات

• البدء السريع
• ما الذي يحجبه
• كيف يقارن cplt
• التثبيت
• الاستخدام
• التهيئة
• البنية
• الأمان
• الشبكة والوكيل (proxy)
• حرّاس الأوامر
• التأثيرات المعروفة
• القيود
• المساهمة
• المراجع

وثائق مفصّلة: التهيئة · الوكيل وتصفية النطاقات · حارس أمر gh · حارس أمر git · التأثيرات المعروفة · تفاصيل الأمان · نموذج الأمان

البدء السريع

brew install navikt/tap/cplt   # macOS. On Debian or Ubuntu, see apt below
cplt --shell-install        # make 'copilot' run sandboxed (persistent)
                            # --agent opencode for any other agent
cplt doctor                 # check your environment
cplt -- -p "fix the tests"  # run Copilot in sandbox

وكلاء آخرون وأوامر بيئة العزل:

cplt --agent opencode                       # OpenCode (Copilot subscription)
cplt --agent opencode --pass-env ANTHROPIC_API_KEY  # third-party provider
cplt --agent shell                          # interactive sandboxed shell (no AI)
cplt exec -- npm install                    # sandbox any command directly
cplt exec -c "npm install && npm test"      # compound commands in sandbox
alias npm="cplt exec -- npm"               # sandboxed npm for every invocation

النشر على مستوى الفريق

# 1. Generate per-repo policy
cplt init --write

# 2. Developers approve on first run
cplt trust accept --all

# 3. Tune the command guards (both block by default)
cplt config set git_guard.protect_default_branch_only false # block every push, not just main
cplt config set git_guard.mode warn                         # observe instead of blocking

ما الذي يحجبه

يحجب وضع الحماية (sandbox) الوصول إلى بيانات الاعتماد والأسرار في النواة. تحجب حواجز الأوامر العمليات المدمِّرة. ينطبق كل قيد على الوكيل وعلى كل عملية يُشغّلها.