شرح Harp: رتّب وكلاء Claude Code وCodex فشريط جانبي هاني فـ macOS

Harp هو fork غير رسمي ديال macOS من التيرمينال Warp المفتوح المصدر. كيخلّي إمكانيات التيرمينال والذكاء الاصطناعي والسحابة ديال Warp خدامة، ولكن كيبدّل شريط التبويبات التقليدي بشريط جانبي مصمّم لوكلاء البرمجة اللي كيبقاو خدامين مدة طويلة.

مع Harp، تقدر تشغّل بزاف ديال جلسات Claude Code وCodex حدّ حدّ، وتشوف بسرعة شنو من الجلسات خدامة، كتسنى تدخلك، سالات، خدامة فالخلفية، ولا حاطّها على جنب. Harp ما كيشغّلش السيرفرات ديالو؛ ميزات Warp الأصلية كتبقى كتتواصل مع سيرفرات Warp بنفس الطريقة ديال Warp.

شنو كيضيف Harp

حالة الوكيل فالنظرة الأولى

كل سطر فالشريط الجانبي يقدر يبيّن حالة جلسة Claude Code ولا Codex. العلامة ديال الرسائل اللي ما تقراتش كتبقى حتى كتفتح الجلسة، النقطة كتعني باللي الخدمة فالخلفية مازال خدامة، والقمر كيميّز التبويب اللي حطّيتيه على جنب. استعمل Cmd+R باش تعاود تسمّي التبويب.

مجموعات دائمة

تقدر تحطّ التبويبات فمجموعات مسمّاة باش تبقى المشاريع والوكلاء منظّمين. ملي كتفعّل تكامل tmux، Harp كيخزّن المجموعة والترتيب فجلسات tmux. بهاد الطريقة التخطيط كيبقى حتى من بعد إعادة التشغيل، وكيقدرو زبناء tmux الآخرين يشوفو نفس الترتيب.

حلقات حدود الاستعمال

تذييل الشريط الجانبي يقدر يبيّن جوج ديال الحلقات لكل مزوّد: وحدة لفترة خمس ساعات ووحدة للحدّ الأسبوعي. Harp كيقرى هاد القيم من ملف JSON محلّي كيتحافظ عليه بأداة من اختيارك. ما كيجبدش بيانات الاستعمال بوحدو. شوف التوثيق ديال صيغة حلقات الحدود باش تعرف الصيغة المتوقعة للملف.

جلسات tmux مناسبة للهاتف

الجلسات المرتابطة بـ tmux تقدر تحمل الاسم ديالها، والمجموعة، وحالة القراءة، وعلامة عدم النشاط. جلسة tmux تبدا من بلاصة أخرى، بحال من الهاتف عبر SSH، تقدر تطلب تبويب فـ Harp إلا عيّنت خيار tmux @warp_adopt على 1.

ثبّت Harp

ثبّت آخر نسخة ديال macOS

1. حلّ آخر إصدار ديال Harp من صفحة الإصدارات ديال GitHub.
2. نزّل الملف Harp-<version>.dmg.
3. حلّ صورة القرص وجرّ Harp لمجلد Applications.

Harp كيستعمل معرّف الحزمة ديالو، com.dominikmartn.Harp، ومخطط URL ديالو، harp://، ومجلد الإعدادات ديالو، ~/.harp. هاد الشي كيخلّيه يخدم حدّ Warp بلا ما يشارك معاه هاد الموارد.

بنِيه من المصدر

باش تبني Harp براسك، استعمل macOS وسلسلة أدوات Rust المحدّدة فـ rust-toolchain.toml. من جذر المستودع، شغّل سكريبت الإعداد مرة وحدة:

./script/bootstrap

من بعد كمّل الترجمة وشغّل التطبيق فنسخة التصحيح:

./script/run

البناء كينتج target/debug/bundle/osx/Harp.app وكيشغّلو. سكريبت التشغيل ديال macOS كيوقّع التطبيق بأول هوية Apple Development فـ keychain ديالك، ولا كيرجع لتوقيع ad-hoc. باش تحصل على DMG موقّع وقابل للتوثيق، استعمل script/release_macos وراجع مخرجات المساعدة ديالو.

كوّن Harp

التكاملات الإضافية ديال Harp معطّلة افتراضياً. أنشئ ولا عدّل ~/.harp/settings.toml، ومن بعد فعّل الميزات اللي محتاج. Harp كيعيد تحميل ملف الإعدادات ملي كيتبدّل.

[integrations.limit_rings]
enabled = true
file = "~/.cache/limit-rings.json"

[integrations.tmux]
enabled = true

فعّل حلقات حدود الاستعمال

عيّن integrations.limit_rings.enabled على true، ووجّه integrations.limit_rings.file لملف JSON المحلّي اللي فيه قيم الاستعمال ديال المزوّد. الرمز ~ كيمثّل المجلد الرئيسي ديالك.

فعّل المزامنة مع tmux

عيّن integrations.tmux.enabled على true باش تفعّل المزامنة مع tmux، وتبنّي الجلسات، واكتشاف الوكلاء داخل tmux. Harp كيتحقّق من tmux كل 10 ثواني.

مع تفعيل tmux، يمكن مزامنة الأسماء، والمجموعات، والترتيب، وعلامات القراءة، وعلامات عدم النشاط، والجلسات اللي تم تبنّيها. إلا كنت محتاج سلوك مخصّص، يقدر integrations.tmux.session_script يشير لسكريبت كيتكلف بإعادة التسمية وإعادة التجميع. السكريبت كيتوصل بالأوامر بهاد الصيغ:

<script> rename <shell_pid> <group> <title>
<script> group <session_id> <old_group> <new_group>

عدّل الشريط الجانبي وشريط أدوات الوكلاء

• appearance.vertical_tabs.full_tab_menu القيمة الافتراضية ديالو هي true. عيّنو على false باش تنقص قوائم التبويبات والمجموعات للأفعال الأساسية. نفس الخيار متاح فـ Settings > Appearance > Tabs.
• agents.third_party.should_render_cli_agent_toolbar القيمة الافتراضية ديالو هي false. عيّنو على true باش ترجع شريط الأدوات الأصلي تحت جلسات وكلاء CLI.

ملي كيكون شريط أدوات وكلاء CLI التابعين لجهة خارجية معطّل، حدّث إضافة Warp الخاصة بـ Claude Code من خلال سوق الإضافات ديال Claude Code، كيف موضّح فالمشروع.

استعمل Harp مع وكلاء البرمجة

1. حلّ Harp وأنشئ جلسات لسير العمل ديالك مع Claude Code ولا Codex.
2. عاود سمّي التبويبات باستعمال Cmd+R باش يكون الغرض ديالها واضح.
3. حطّ الجلسات المرتابطة فمجموعات مسمّاة، بحال مجموعة لكل مشروع.
4. راقب مؤشرات الحالة فالشريط الجانبي باش تعرف الجلسات اللي محتاجة انتباهك، أو مازال خدامة، أو سالات.
5. حطّ على جنب الجلسات اللي ما محتاجهاش دابا؛ Harp كيميّزها بالقمر.
6. حلّ الجلسات اللي ما تقراتش ملي تكون واجد تراجع المخرجات ديالها.

تقدر تخلق تابّات جداد باستعمال Cmd+T، ولا بالنقر جوج مرات، ولا من المينيو ديال النقر بالزرّ اليميني فبلاصة خاوية فالشريط الجانبي. المشروع كيحيد بالقصد بعض أدوات شريط التابّات، من بينها خانة البحث، اختيارات العرض، وأزرار إعداد التابّات.

تبنّى سيشن بدا فبلاصة خرى

إلى تخلق سيشن ديال tmux من جهاز ولا تيرمينال خرين، تقدر تطلب من Harp يتبنّاه كتاب فتاب. فسيشن tmux المعني، شغّل:

tmux set-option @warp_adopt 1

من بعد ما كتفعّل الربط مع tmux، يقدر Harp يتبع داك السيشن ويبيّن السمية ديالو، المجموعة ديالو، والحالة ديالو فالشريط الجانبي. هادشي مفيد باش تكمل الخدمة اللي بديتيها عبر SSH، حتى من التليفون.

ربط الإبلاغ على المهام اللي خدامة فالخلفية ديال Claude Code

المستودع فيه hook ديال Claude Code كيبلّغ Harp بالمهام اللي خدامة فالخلفية. تعليمات الربط كاينة فـ integrations/claude-code. استعمل هاد التعليمات إلا بغيتي النشاط اللي فالخلفية يبان فالشريط الجانبي.

اختيارات متقدمة للتطوير

تتبّع تغييرات الحالة

باش تدير اختبارات التراجع مقابل transcript ديال agent، شغّل نسخة debug باستعمال WARPOSS_STATUS_TRACE=1. كيسجّل Harp تغييرات الحالة فـ ~/Library/Logs/harp.log على شكل سطور فيها [status-check].

شغّل بلا login حقيقي

حطّ WARPOSS_SKIP_LOGIN=1 وقت التشغيل باش يبدا بمستخدم تجريبي وتفشل الطلبات اللي محتاجة المصادقة. هاد الخيار مخصّص للتشغيلات الآلية اللي ما كتستعملش login.

استعمل بروفايل معزول لبيانات debug

فنسخ debug، حطّ WARP_DATA_PROFILE=<name> باش تبقى الإعدادات والبيانات فـ ~/.harp-<name> بلاصة المسار الافتراضي ديال البروفايل.

تحقّق من المساهمات

قبل ما تصيفط التغييرات، شغّل اختبارات ما قبل الإرسال ديال المستودع:

./script/presubmit

هادشي كيشغّل التنسيق، Clippy، والاختبارات.

الخلاصة

كيحوّل Harp تيرمينال Warp لمساحة خدمة كتعاونك تسير بزاف ديال سيشنات Claude Code وCodex اللي كيطولو فالخدمة. نصّب تطبيق macOS ولا بنِيه من المصدر، فعّل تكاملات tmux وlimit-ring ملي تحتاجهم، ومن بعد استعمل المجموعات ومؤشرات الحالة باش تبقى الخدمة اللي كيسيروها الـ agents منظمة. Harp fork غير رسمي ديال Warp، لذلك بلّغ على المشاكل الخاصة بـ Harp فالمستودع ديالو، ماشي عند Warp.