الخطوات الأولى
- التثبيت. نزّل
Hangar-Setup.exeوشغّله. يُثبَّت Hangar لمستخدمك فقط، دون صلاحيات المسؤول. - شغّل وكيلًا. اختر مجلد مشروع ضمن «جلسة جديدة»، واختر «خاصة» أو «فريق»، ثم انقر على وكيل. يعرض Hangar كل وكيل يجده على جهازك مع إصداره؛ وضمن «فريق» يعرض فقط الوكلاء الذين يمكن تشغيلهم كجلسات فريق.
- أضف فريقك (اختياري). انقر على «تسجيل الدخول» في أسفل الشريط الجانبي، وأكّد الرمز في متصفحك، ثم اربط المشروع. يرى أعضاء الفريق الذين ينضمون إلى المشروع نفسه بعضهم بعضًا في نافذة الفريق.
- صورة الملف الشخصي (اختياري). تظهر صورة ملفك الشخصي من حساب Hangar في الشريط الجانبي. ترفعها من هذا الموقع في الحساب › الإعدادات.
تنزيل Hangar الوكلاء المدعومون
إذا عرض Windows تحذير SmartScreen أثناء التثبيت، فاختر «مزيد من المعلومات» ثم «تشغيل على أي حال». لم يُوقَّع برنامج التثبيت بعد بشهادة توقيع التعليمات البرمجية. أما التحديثات داخل Hangar فهي موقّعة ومُتحقَّق منها دائمًا.
المتطلبات: Windows 10 الإصدار 1809 أو أحدث، أو Windows 11 (x64). تثبّت الوكلاء بنفسك، بحساباتك الخاصة. يلزم Git لجلسات الفريق (worktrees) وتتبع التغييرات وعمليات الإيداع والملاحظات المشتركة.
اختصارات لوحة المفاتيح
لا يلتقط Hangar إلا التركيبات التي لا تحتاجها الأصداف والوكلاء. أما نظيراتها دون Shift فتبقى للبرنامج في الطرفية: لا تزال Ctrl+B وCtrl+F وCtrl+P تصل إلى الصدفة أو الوكيل.
| المفاتيح | الإجراء |
|---|---|
| Ctrl+Shift+P | الوصول السريع: ابحث عن الجلسات والبرامج والملفات وعمليات الإيداع الأخيرة والإعدادات وكل أوامر القوائم |
| Ctrl+Shift+S | البحث في إخراج كل الجلسات |
| Ctrl+Shift+M | عرض كل الجلسات كمربعات حية |
| Ctrl+Shift+H | إظهار العرض الرئيسي؛ وتواصل الجلسات عملها |
| Ctrl+Shift+T | جلسة جديدة بآخر برنامج مستخدم |
| Ctrl+Shift+W | إغلاق الجلسة |
| Ctrl+Tab | الجلسة التالية |
| Ctrl+Shift+Tab | الجلسة السابقة |
| Ctrl+Shift+A | الانتقال إلى الجلسة التالية التي تنتظرك |
| Ctrl+Shift+N | ملاحظة سريعة |
| Ctrl+Shift+D | إظهار التغييرات في مجلد الجلسة أو إخفاؤها |
| Ctrl+Shift+F | البحث في سجل الطرفية |
| Ctrl+Shift+B | طي الشريط الجانبي أو توسيعه |
| Ctrl+, | فتح الإعدادات |
| Ctrl++ | تكبير النص |
| Ctrl+- | تصغير النص |
| Ctrl+0 | إعادة تعيين حجم النص |
| المفاتيح | الإجراء |
|---|---|
| Ctrl+C | نسخ التحديد؛ وإن لم يوجد تحديد يذهب المفتاح إلى البرنامج (مقاطعة) |
| Ctrl+Shift+C | نسخ التحديد مع إبقائه محددًا |
| Ctrl+V | لصق؛ وإذا كانت في الحافظة صورة، يلصق Hangar مسار ملف الصورة المحفوظ |
| Shift+Enter | سطر جديد في طلب الوكيل دون إرساله |
| Ctrl+Shift+مسافة | اضغط مع الاستمرار للإملاء؛ يُتعرّف على الكلام على حاسوبك أنت |
| المفاتيح | الإجراء |
|---|---|
| Enter | التطابق التالي |
| Shift+Enter | التطابق السابق |
| Esc | إغلاق البحث |
| المفاتيح | الإجراء |
|---|---|
| F6 / Shift+F6 | عندما تكون الملاحظات مفتوحة، انقل التركيز بين الطرفية وقائمة الملاحظات والمحرر |
| F2 | إعادة تسمية الملاحظة |
| Alt+↑ / Alt+↓ | تحريك الجلسة المحددة إلى الأعلى أو الأسفل في الشريط الجانبي |
| Ctrl+Enter | إرسال رسالة إلى عدة جلسات |
الملفات الشخصية في profiles.toml
توجد طرفياتك ووكلاؤك الخاصون في profiles.toml داخل مجلد الإعدادات، وعلى Windows في %APPDATA%\com.feoren.hangar\profiles.toml. إذا لم يكن الملف موجودًا، ينشئه Hangar عند التشغيل من قالب مشروح، ويتضمن PowerShell 7 وWindows PowerShell وموجه الأوامر.
أسرع طريقة لفتح الملف هي من الإعدادات عبر الطرفيات والوكلاء › فتح ملف الملفات الشخصية.
لا يحتاج الوكلاء الموجودون في الكتالوج إلى ملف شخصي، فـ Hangar يعرفهم من تلقاء نفسه. لتشغيل أحدهم بطريقة مختلفة، أنشئ ملفًا شخصيًا بالمعرّف id نفسه: فهو يستبدل اسم عنصر الكتالوج وأيقونته وأمره ووسائطه وموضعه، بينما تبقى صفحة المشروع وأمر التثبيت من الكتالوج.
| الحقل | المعنى |
|---|---|
id | إلزامي. فريد ودون مسافات. يرفض Hangar معرّفين يختلفان فقط في الأحرف الكبيرة والصغيرة. |
name | إلزامي. الاسم المعروض في الشريط الجانبي. |
command | إلزامي. اسم برنامج من PATH أو مسار كامل. دون صياغة الصدفة: يشغّل Hangar البرنامج مباشرة. |
args | الوسائط على شكل قائمة، مثل ["--model", "opus"]. |
cwd | مجلد عمل ثابت. بدون هذا الحقل يبدأ البرنامج في المجلد الذي تختاره. |
icon | حرف أو حرفان لأيقونة الشريط الجانبي. |
[profile.env] | متغيرات البيئة في جدول مستقل. لا تضع الأسرار هنا. |
secret_env | أسماء المتغيرات التي يحفظ Hangar قيمها في إدارة بيانات الاعتماد في Windows، مثل ["GITHUB_TOKEN"]. |
resume_args | وسائط استئناف المحادثة الأخيرة. تحل محل args بدلًا من أن تُضاف إليها. |
version_args | وسائط الاستعلام عن الإصدار، والقيمة الافتراضية ["--version"]؛ وتعني []: لا تشغّل البرنامج أبدًا لقراءة إصداره. |
latest, packages, self_update, update_hint | مكان نشر الإصدارات الجديدة وكيفية تحديث Hangar للبرنامج بنقرة واحدة. يشرح القالب المشروح في الملف كل حقل. |
مثال
يشغّل الملف الشخصي الأول Claude Code من الكتالوج بنموذج مختلف. والثاني PowerShell خاص بك مع مجلد عمل ثابت ومتغير عادي وآخر سري.
[[profile]]
id = "claude"
name = "Claude Code (Opus)"
command = "claude"
args = ["--model", "opus"]
icon = "C"
[[profile]]
id = "pwsh-shop"
name = "PowerShell (Shop)"
command = "pwsh"
args = ["-NoLogo"]
cwd = 'C:\src\shop'
icon = "SH"
secret_env = ["GITHUB_TOKEN"]
[profile.env]
DOTNET_CLI_TELEMETRY_OPTOUT = "1"
المتغيرات السرية
لا تظهر قيم secret_env في الملف أبدًا. تُدخلها في الإعدادات حيث تحرّر الملف الشخصي. يحفظها Hangar في إدارة بيانات الاعتماد في Windows ضمن الخدمة hangar، ولا يضعها في بيئة الجلسة إلا عند بدئها. يجب ألا يظهر المتغير نفسه في [profile.env] وsecret_env معًا.
بعد الحفظ، يعيد Hangar تحميل الملف بمجرد عودتك إلى نافذته، أو يمكنك اختيار «إعادة تحميل الملفات الشخصية». يعرض Hangar الخطأ مع السطر والعمود، وتبقى الجلسات الجارية كما هي.
الإشعارات للوكلاء المنتظرين
يُظهر لك الشريط الجانبي بنظرة واحدة أي وكيل يعمل، وأيه انتهى، وأيه ينتظرك. وكل ما عدا ذلك تجده في الإعدادات ضمن التنبيهات.
- إبراز الجلسات المنتظرة: تنبض الجلسة بلطف عندما ينتهي وكيل أو ينتظرك بينما تنظر إلى مكان آخر. تختار بعد كم ثانية من الهدوء يظهر التنبيه.
- الألوان والنبض: لكل من «يعمل» و«انتهى» و«يسألك» و«إيقاف مؤقت» لونه وشدة نبضه ومدة نبضه، مع معاينة.
- الصوت: نغمة ناعمة من نغمتين عندما تنتظر جلسة لا تراها حاليًا. وإذا انتهى برنامج بخطأ، تكون النغمة أخفض. يمكن ضبط مستوى الصوت.
- إشعار سطح المكتب: فقط عندما يكون Hangar في الخلفية. انقر عليه لفتح الجلسة.
- وميض شريط المهام: فقط عندما لا يكون Hangar في المقدمة. يتوقف الوميض بمجرد انتقالك إلى نافذته.
- العدد على شريط المهام: تُظهر أيقونة صغيرة على زر شريط المهام عدد الجلسات المنتظرة، من 1 إلى 9، و9+ لما يزيد على ذلك.
- إشعار إلى هاتفك: عبر ntfy أو Pushover عندما تنتظرك جلسة. مع ntfy اختر موضوعًا يصعب تخمينه، لأن أي شخص يعرفه يمكنه قراءة الإشعارات.
- ساعات الهدوء: خلال الساعات التي تختارها لا يوجد صوت ولا إشعار ولا رسالة إلى الهاتف ولا وميض في شريط المهام. وتبقى الألوان وعدد الجلسات المنتظرة.
- مواصلة العمل في منطقة الإعلامات: عند إغلاق النافذة تستمر جلساتك في العمل، وتُظهر الأيقونة في منطقة الإعلامات عدد الجلسات المنتظرة. لإنهاء Hangar، انقر بزر الماوس الأيمن على الأيقونة.
ينقلك Ctrl+Shift+A مباشرة إلى الجلسة المنتظرة التالية.
جلسات الفريق وworktrees
ضمن «جلسة جديدة» تختار «خاصة» أو «فريق». تعمل الجلسة الخاصة مباشرة في مجلدك، لك وحدك. أما جلسة الفريق فتحصل على Git worktree خاص بها وتكون مرئية لفريقك، فيستطيع عدة وكلاء تعديل المشروع نفسه في الوقت ذاته دون أن يسحب أحدهم الملفات من تحت الآخر.
لكل جلسة فريق ينشئ Hangar فرعًا hangar/… من الحالة الحالية. عندما يريد وكيل تعديل ملف تعمل عليه جلسة أخرى، يوقفه Hangar ويسألك؛ أجب «دائمًا» أو «أبدًا» لملف أو مجلد، وسيتذكر Hangar ذلك لكل مشروع. يعمل Claude Code وCodex CLI وOpenCode وPi كجلسات فريق.
توجد worktrees في مجلد بيانات التطبيق ضمن %LOCALAPPDATA%\com.feoren.hangar\worktrees\، وليس بجوار مستودعك. وهذا يُبقي المستودعات والمجلدات المتزامنة نظيفة.
عندما يبدأ وكيل في worktree جديد، يتحقق أولًا من وجود عمليات إيداع جديدة في upstream ويسألك قبل جلبها. يمكنك إيقاف ذلك في الإعدادات ضمن «الطرفيات والوكلاء».
عندما تنتهي جلسة فريق، يزيل Hangar الـ worktree الخاص بها مرة أخرى ما لم يكن لا يزال يحتوي على تغييرات أو ملفات مُتجاهَلة مثل مخرجات البناء، أو ما لم تكن جلسة أخرى لا تزال تعمل فيه. وإذا كان للفرع عمليات إيداع لم تُدمج بعد، فإنه يبقى. لا يفرض Hangar أي شيء أبدًا.
يجب أن يكون Git مثبّتًا وأن يكون المجلد داخل مستودع Git. لا يشغّل Hangar أداة Git على مشاركات الشبكة، ولا ينطبق الفحص قبل التعديلات داخل WSL.
الملاحظات
تنتمي الملاحظات إلى مشروع الجلسة أو إلى القسم العام. إنها ملفات Markdown حقيقية يمكنك فتحها في مستكشف الملفات أيضًا.
- يبدأ Ctrl+Shift+N ملاحظة سريعة من أي مكان.
- أرسل النص المحدد في الطرفية مباشرة إلى ملاحظة، أو أرسل ملاحظة إلى جلسة. هناك تُلصق دون Enter، لتتمكن من مراجعتها أولًا.
- تنتقل الملاحظات المحذوفة إلى «المحذوفة مؤخرًا»، حيث يمكنك استعادتها.
- في أعلى لوحة الملاحظات تبدّل بين «خاصة» و«مشتركة»، فتبقى ملاحظاتك منفصلة عن ملاحظات الفريق.
ملاحظات مشتركة ومشفّرة
عندما تفعّل الملاحظات المشتركة لمشروع، يشفّرها Hangar ويحفظها في المجلد .hangar\notes\ داخل المستودع. وتنتقل مع عمليات الإيداع الخاصة بك. يمكن لأي شخص لديه المستودع والرمز قراءتها. لا يُكتب النص المفكوك تشفيره على القرص أبدًا، ولا يُجري Hangar أي إيداع من تلقاء نفسه.
عند التفعيل، يعرض Hangar رمز استرداد الملاحظات مرة واحدة. احفظه في مكان آمن: فبدونه تضيع الملاحظات نهائيًا إذا فقد هذا الكمبيوتر مفتاحه. وبالرمز يمكنك فتحها على نسخة أخرى من المستودع أيضًا.
ملف تعليمات واحد لجميع الوكلاء
يوجد HANGAR.md في مجلد الإعدادات بجانب profiles.toml ويعمل مثل AGENTS.md أو CLAUDE.md، لكن دون ملف في مستودعك. يمرّر Hangar محتواه إلى كل وكيل يقبل تعليمات إضافية: Claude Code وCodex CLI وAider. وهو مفعّل افتراضيًا؛ والقالب فارغ ولا يرسل شيئًا حتى تكتب فيه.
تفتح الملف من الإعدادات ضمن «الطرفيات والوكلاء» › «فتح HANGAR.md». وهناك أيضًا تشغّل «استخدام HANGAR.md لكل وكيل» أو توقفه. لا تكتب فيه أسرارًا: يظهر النص في سطر أوامر الوكلاء.
مواقع التخزين
يحفظ Hangar إعداداته في ملف تعريف المستخدم الخاص بك، وعلى Windows في %APPDATA% و%LOCALAPPDATA%. وحدها الملاحظات المشتركة توجد في المشروع.
| الموقع | المحتوى |
|---|---|
%APPDATA%\com.feoren.hangar\profiles.toml | ملفاتك الشخصية |
%APPDATA%\com.feoren.hangar\HANGAR.md | تعليماتك لجميع الوكلاء |
%APPDATA%\com.feoren.hangar\account.json | الخادم المختار والخوادم التي سجّلت الدخول إليها؛ دون رموز وصول |
%LOCALAPPDATA%\com.feoren.hangar\workspace.json, scrollback\ | الجلسات المفتوحة وسجلها، ليستعيدها Hangar بعد إعادة التشغيل |
%LOCALAPPDATA%\com.feoren.hangar\notes\ | الملاحظات الخاصة كملفات .md، لكل مجلد مشروع وضمن general؛ والمحذوفة في .trash |
%LOCALAPPDATA%\com.feoren.hangar\worktrees\ | worktrees جلساتك |
%LOCALAPPDATA%\com.feoren.hangar\pastes\ | لقطات الشاشة الملصقة؛ يحذفها Hangar بعد أسبوع |
%LOCALAPPDATA%\Hangar | البرنامج نفسه |
.hangar\notes\ | الملاحظات المشتركة، مشفّرة، في المستودع |
| إدارة بيانات الاعتماد في Windows | متغيرات الملفات الشخصية السرية، وتسجيل دخولك، والمفاتيح الخاصة بالفريق والملاحظات المشتركة |
خادم فريقك الخاص
بالنسبة للفرق، يتصل Hangar افتراضيًا بالخدمة الرسمية على https://hangar.feoren.com/api/v1. ودون تسجيل الدخول يعمل كل شيء باستثناء نافذة الفريق.
إذا كان فريقك يشغّل خادم Hangar خاصًا به، فأدخل عنوانه في الإعدادات ضمن الحساب › عنوان الخادم (استضافة ذاتية) وانقر على تطبيق. إذا تركته فارغًا، تُستخدم الخدمة الرسمية مجددًا.
العنوان هو أساس واجهة API للخادم، مثل https://team.example.com/api/v1. يجب أن يبدأ بـ https://؛ ولا يسمح Hangar بـ http العادي إلا لـ localhost و127.0.0.1 و[::1]. لا يُسمح باسم المستخدم وكلمة المرور والاستعلام والجزء. يحفظ Hangar العنوان في account.json؛ وتبقى عمليات تسجيل الدخول إلى الخوادم الأخرى محفوظة على الجهاز.
يجب أن يتحدث هذا الخادم الواجهة نفسها التي تستخدمها الخدمة الرسمية: تسجيل الدخول عبر تدفق أجهزة OAuth، والحساب والمشاريع، إضافة إلى تذاكر المُرحِّل الذي ينقل بيانات الفريق عبر WebSocket. أنواع بيانات البروتوكول وتشفيره مفتوحة في مستودع التطبيق، في الحزمتين hangar-team-protocol وhangar-team-crypto بموجب ترخيص MIT.
كل ما تتم مشاركته مع الفريق يُشفَّر على جهازك. يخزّنه الخادم ويعيد توجيهه لكنه لا يستطيع قراءته. لا تنضم الأجهزة الجديدة إلا بعد أن يقارن شخص ما رقم الأمان ويؤكده.
الوضع الحالي: لم يُنشر بعد برنامج خادم جاهز للاستضافة الذاتية. يمكن للتطبيق بالفعل استخدام عنوان خاص بك، لكن لا يوجد هنا دليل تثبيت حتى الآن.
هل تخطط لاستخدام Hangar في شركة وتحتاج إلى خادم خاص بك؟ راسلنا وسندرس حالتك.