عن المشروع

يعد Longhouse أداة مفتوحة المصدر تعمل كجهاز تحكم عن بعد وجدول زمني قابل للبحث لوكلاء البرمجة. لا يحل الأداة محل وقت تشغيل الوكيل، بل توحد الجلسات التي تشغلها عبر مختلف الموفرين والأجهزة. يمكنك مشاهدة الجلسات المباشرة من واجهة ويب، والبحث في كل ما قام به الوكلاء، وإرسال تعليماتك التالية بينما يستمر الوكيل في العمل في محطته الطرفية الفعلية على جهازك. تشمل الموفرين المدعومين Claude Code وCodex CLI وCursor Agent وOpenCode وAntigravity وPi Agent. تتم مزامنة كل موفر في جدول زمني واحد قابل للبحث. يختلف مستوى التحكم عن بعد؛ فبالنسبة لـ Claude Code وCodex، يمكنك البحث والتشغيل والمقاطعة والتوجيه أثناء العمل والاستئناف. تدعم Cursor وOpenCode البحث والتشغيل والمقاطعة والاستئناف ولكن ليس التوجيه أثناء العمل. تدعم Antigravity البحث والتشغيل فقط، ولا تدعم المقاطعة أو الإنهاء أو إعادة الاتصال. تظل جلسات CLI الأساسية للموفرين مدرجة في الجدول الزمني ولكنها تظل غير مدارة، مما يعني أنها قابلة للبحث والمراقبة دون تحكم Longhouse عن بعد. تتكون البنية من مكونين رئيسيين: وكيل الجهاز (Machine Agent)، وهو محرك Rust يعمل على كل جهاز تطوير ويرسل أحداث الجلسة، ومضيف وقت التشغيل (Runtime Host)، وهو تطبيق FastAPI مع واجهة ويب مجمعة وتخزين SQLite، مخصص للعمل حيث تكون المتانة مطلوبة. على جهاز كمبيوتر محمول، يمكن تشغيل كلاهما معاً للتجربة، ولضمان المتانة، يمكن تشغيل مضيف وقت التشغيل على جهاز يعمل دائماً مثل VPS أو خادم منزلي أو Mac mini. يتم تقديم واجهة الويب افتراضياً على http://localhost:8080. تتضمن خيارات التثبيت تطبيق macOS، ومثبت shell لنظام Linux أو WSL أو Mac بدون التطبيق، ومثبت خادم لمشغلي مضيف وقت التشغيل. يقوم مثبت shell بإعداد الزوج الأصلي. بعد التثبيت، تقوم بالمصادقة باستخدام longhouse auth ويمكنك إصلاح جهاز تم تكوينه باستخدام longhouse machine repair. تتطلب الاستضافة الذاتية لمضيف وقت التشغيل تعيين تجزئة كلمة مرور وسرين عشوائيين، ثم تشغيل longhouse-server serve. يتم رفض الربط خارج localhost بدون مصادقة افتراضياً. يتم تطوير Longhouse بنشاط وهو حالياً في مرحلة ما قبل الإصدار. الأداة مرخصة بموجب Apache-2.0 مع نواة مفتوحة؛ ويتوفر خيار مستضاف مقابل 5 دولارات شهرياً. يوجد عميل iOS في المستودع ويتعامل مع دفع APNs عند الحاجة، ولكن لا يوجد إصدار TestFlight أو App Store ولا ملف IPA في أي إصدار. لاستخدامه على الهاتف اليوم، يمكنك فتح Xcode harness في Xcode وتشغيله على جهازك الخاص. يمكن للمساهمين استنساخ المستودع واستخدام make dev لواجهة المستخدم المحلية مع إعادة التحميل السريع، وmake dev-demo لخلفية معزولة مع واجهة مستخدم تجريبية، وmake test لاختبارات الوحدة، وmake test-e2e للاختبارات الشاملة. تشمل نقاط الدخول الجيدة واجهة الجدول الزمني للويب، ومحللات استيعاب إضافية لـ CLI الخاص بالموفر، وتجربة مستخدم الأوامر الفرعية لـ CLI، والتوثيق.