دليل تركيب Agent-Deck: إدارة وكلاء AI من الطرفية خطوة بخطوة
Terminal session manager for AI coding agents. One TUI for Claude, Gemini, OpenCode, Codex, and more.
خريطة الصفحة
اختر القسم الذي تحتاجه الآن
- حالات استخدام عملية
- المقارنة مع البدائل
- الخصوصية والتكلفة
- القيود
- الحكم النهائي
- ما المشكلة التي يحلها هذا الدليل؟
- Input → Process → Output
- خطوات التطبيق العملية
- جدول مقارنة سريع
- مثال تطبيقي مختصر
- متى لا تستخدم هذا الحل؟
- كيف تقيس النجاح؟
قبل أن تطبق
الفكرة التي تمنع التسرع
تخيل أنك تعمل على مشروع ترجمة وتحتاج إلى Claude لترجمة ملف وGemini لمراجعة الترجمة، لكنك مجبر على التبديل بين نوافذ طرفية متعددة. Agent-Deck يحل هذه المشكلة بواجهة TUI واحدة.
أسئلة التشخيص السريع
قبل أن تطبق، اعرف أين تقف بالضبط
- هل تعمل مع عدة وكلاء AI (Claude, Gemini, OpenCode, Codex) في الطرفية؟
- هل تواجه صعوبة في التبديل بين جلسات متعددة وفقدان السياق؟
- هل تبحث عن أداة TUI مجانية ومفتوحة المصدر لإدارة جلسات AI؟
- هل تستخدم نظام تشغيل macOS أو Linux؟ (Windows يحتاج WSL)
- هل لديك مفاتيح API صالحة للوكلاء الذين تريد استخدامهم؟
- هل تفضل تخزين المفاتيح محلياً وليس على خوادم طرف ثالث؟
- هل أنت مستعد لتجربة أداة في مرحلة مبكرة قد تحتوي على أخطاء؟
نظام التشغيل: Input → Process → Output
لوحة قياس النجاح
لا تعتمد على الانطباع؛ اختر مؤشراً تراجعه
إذا كنت تعمل مع عدة وكلاء AI مثل Claude وGemini في الطرفية، فأنت تعرف التحدي: إدارة جلسات منفصلة، تتبع السياق، والتبديل بين النوافذ. Agent-Deck هو أداة TUI (واجهة مستخدم نصية) مجانية ومفتوحة المصدر (رخصة MIT) تدمج جميع جلسات وكلاء AI في واجهة واحدة. مبني بلغة Go ومكتبة Bubble Tea، يدير جلسات Claude وGemini وOpenCode وCodex. في هذا الدليل، ستتعلم تركيبه خطوة بخطوة من README الرسمي، مع أمثلة عربية عملية وأخطاء شائعة وحلولها.
حالات استخدام عملية
إليك سيناريوهات حقيقية يمكنك تطبيقها فوراً:
- ترجمة مستند: افتح جلسة Claude لترجمة ملف README من الإنجليزية إلى العربية، وجلسة Gemini لمراجعة الترجمة. استخدم التبديل بين الجلسات لمقارنة النتائج.
- مراجعة كود: استخدم Claude لتحليل كود Python، وOpenCode لاقتراح تحسينات. يمكنك تشغيلهما جنباً إلى جنب.
- بحث متعدد الوكلاء: اطرح سؤالاً على Gemini وClaude في نفس الوقت وقارن الإجابات.
المقارنة مع البدائل
Agent-Deck يتفوق بتكامله المباشر مع وكلاء AI، بينما tmux وzellij أدوات عامة تتطلب إعداداً يدوياً.
الخصوصية والتكلفة
الخصوصية: جميع مفاتيح API تخزن محلياً في ملف .env، ولا يتم إرسال أي بيانات إلى طرف ثالث. الأداة تعمل بالكامل على جهازك. التكلفة: الأداة مجانية، لكن استخدام وكلاء AI يتطلب مفاتيح API مدفوعة (لكل وكيل سياسة تسعير خاصة).
القيود
- لا يدعم Windows مباشرة (يحتاج WSL).
- واجهة TUI قد لا تعمل في بعض المحاكيات الطرفية القديمة.
- لا يدعم جميع وكلاء AI (فقط المذكورين).
- المشروع لا يزال في مراحل مبكرة، قد توجد أخطاء.
الحكم النهائي
Agent-Deck أداة قوية لإدارة وكلاء AI من الطرفية، خاصة للمطورين الذين يعملون مع عدة وكلاء يومياً. رغم بعض القيود، فإنه يوفر وقتاً كبيراً ويحسن الإنتاجية. أنصح بتجربته في مشروع جانبي أولاً.
ما المشكلة التي يحلها هذا الدليل؟
هذا الدليل يحول الموضوع من معلومات متناثرة إلى نظام تطبيق واضح: تشخيص، قرار، تنفيذ، قياس، ومراجعة.
Input → Process → Output
- Input: مفاتيح API لوكلاء AI (Claude, Gemini, OpenCode) وملف .env
- Process: Agent-Deck يقرأ ملف .env، يتصل بوكلاء AI عبر CLI، ويعرض جلساتهم في واجهة TUI تفاعلية
- Output: واجهة طرفية واحدة لإدارة جلسات متعددة، مع إمكانية التبديل بينها وحفظ السياق
خطوات التطبيق العملية
- حدد المشكلة بجملة واحدة.
- اختر النتيجة التي تريدها.
- نفذ خطوة صغيرة.
- قِس النتيجة.
- وثق الطريقة التي نجحت.
جدول مقارنة سريع
مثال تطبيقي مختصر
اختر حالة واحدة من حياتك أو عملك، وطبّق عليها خطوة واحدة من الدليل. لا توسع التطبيق قبل أن ترى نتيجة قابلة للقياس.
متى لا تستخدم هذا الحل؟
لا تستخدم هذا الدليل كبديل لمختص في القرارات الطبية أو القانونية أو المالية عالية المخاطر.
كيف تقيس النجاح؟
النجاح يظهر عندما تصبح المشكلة أوضح، والخطوة التالية أسهل، والنتيجة قابلة للمراجعة.
كيف تحافظ على النتيجة؟
وثق ما نجح، راجع المؤشر كل أسبوع، وعدّل خطوة واحدة فقط في كل مرة.
Playbook التطبيق
خطوات عملية مرتبة من التشخيص إلى النتيجة
تثبيت المتطلبات الأساسية
لماذا؟ Agent-Deck مبني بلغة Go، لذا يجب تثبيت Go ومكتبة Bubble Tea.
كيف؟ قم بتثبيت Go من go.dev، ثم شغّل: go install github.com/charmbracelet/bubbletea@latest
الناتج: بيئة Go جاهزة مع مكتبة Bubble Tea.
استنساخ المستودع
لماذا؟ للحصول على كود المصدر وملف README.
كيف؟ git clone https://github.com/nicksanford/agent-deck.git && cd agent-deck
الناتج: مجلد agent-deck يحتوي على الكود.
بناء الأداة
لماذا؟ لتجميع الكود إلى ملف تنفيذي.
كيف؟ go build -o agent-deck .
الناتج: ملف agent-deck التنفيذي.
إعداد ملف .env
لماذا؟ لتخزين مفاتيح API محلياً.
كيف؟ انسخ .env.example إلى .env: cp .env.example .env، ثم املأ المفاتيح مثل CLAUDE_API_KEY=your_key
الناتج: ملف .env بمفاتيح API.
تشغيل Agent-Deck
لماذا؟ لبدء واجهة TUI.
كيف؟ ./agent-deck
الناتج: واجهة TUI تعرض جلسات الوكلاء المتاحة.
اختبار التبديل بين الجلسات
لماذا؟ للتأكد من عمل التكامل.
كيف؟ استخدم مفاتيح الاختصار (مثل Ctrl+Tab) للتبديل بين جلسات Claude وGemini.
الناتج: التبديل السلس بين الجلسات مع حفظ السياق.
قوالب جاهزة للنسخ
حوّل القراءة إلى تنفيذ سريع
CLAUDE_API_KEY=your_claude_key GEMINI_API_KEY=your_gemini_key OPENCODE_API_KEY=your_opencode_key CODEX_API_KEY=your_codex_key
git clone https://github.com/nicksanford/agent-deck.git && cd agent-deck && go build -o agent-deck . && cp .env.example .env && nano .env
مصفوفة الأخطاء
اعرف أين يتعثر الناس وكيف تتجنب ذلك
شجرة القرار
ماذا تفعل حسب حالتك؟
إذا: إذا كنت تستخدم Windows
إذن: استخدم WSL أو انتقل إلى نظام macOS/Linux.
إذا: إذا لم يكن لديك مفاتيح API
إذن: احصل على مفاتيح من مواقع الوكلاء (Claude, Gemini, إلخ).
إذا: إذا واجهت أخطاء في التجميع
إذن: تأكد من تثبيت أحدث إصدار من Go ومكتبة Bubble Tea.
إذا: إذا كنت تريد استخدام وكلاء غير مدعومين
إذن: انتظر تحديثات المشروع أو ساهم في الكود.
خطة تطبيق 7 أيام
جدول صغير يمنع التسويف
- اليوم 1: تثبيت Go واستنساخ المستودع.
- اليوم 2: بناء الأداة وإعداد ملف .env.
- اليوم 3: تشغيل الأداة واختبار جلسة Claude.
- اليوم 4: إضافة جلسة Gemini واختبار التبديل.
- اليوم 5: تجربة حالة استخدام (ترجمة مستند).
- اليوم 6: توثيق الأخطاء التي واجهتها وحلولها.
- اليوم 7: مشاركة التجربة مع المجتمع.
حقائق سريعة تحفظها
نقاط مختصرة ترجع لها لاحقاً
1. Agent-Deck أداة TUI مجانية ومفتوحة المصدر (رخصة MIT).
2. مبني بلغة Go ومكتبة Bubble Tea.
3. يدير جلسات Claude وGemini وOpenCode وCodex.
4. جميع مفاتيح API تخزن محلياً في ملف .env.
5. لا يدعم Windows مباشرة (يحتاج WSL).
6. المشروع لا يزال في مراحل مبكرة.
7. يتطلب مفاتيح API مدفوعة لكل وكيل.
8. يمكن التبديل بين الجلسات وحفظ السياق.
9. مقارنة بـ tmux: تكامل مباشر مع وكلاء AI.
أسئلة شائعة
إجابات مباشرة على ما يبحث عنه الزائر
مصطلحات سريعة
تعريفات مختصرة تمنع الالتباس
واجهة مستخدم نصية تعمل في الطرفية.
مكتبة Go لبناء تطبيقات TUI تفاعلية.
وكيل AI مثل Claude أو Gemini.
ملف نصي لتخزين المتغيرات البيئية مثل مفاتيح API.
نظام Windows الفرعي لتشغيل Linux.
أسئلة مرتبطة يبحث عنها الناس
استخدمها كمسارات متابعة داخل نفس الموضوع
لماذا هذا المرجع يتجاوز الموضوع نفسه؟
تحول القارئ: من مطور يفتح نوافذ طرفية متعددة لإدارة وكلاء AI، إلى مطور يدير جميع الجلسات من واجهة TUI واحدة بسلاسة.
- إدارة المشاريع: استخدام Agent-Deck مع Git worktree لتنظيم جلسات AI حسب المشروع
- الأتمتة: دمج Agent-Deck مع سكريبتات Bash لبدء جلسات تلقائياً
- الأمان: إدارة مفاتيح API بأمان عبر ملف .env و Git ignore
كيف تستخدم هذا المرجع لاحقاً؟
القيمة الحقيقية تظهر عند العودة والتطبيق
لا تتعامل معه كمقال يُقرأ مرة واحدة. استخدمه كلوحة تشغيل: ارجع للتشخيص عند ظهور المشكلة، وللقوالب عند التطبيق، ولمؤشرات القياس عند المراجعة.
Agent-Deck أداة فعالة لإدارة وكلاء AI من الطرفية. باتباع هذا الدليل، ستتمكن من تركيبه وتشغيله بنجاح. تذكر أن المشروع لا يزال قيد التطوير، لذا تابع المستودع على GitHub للتحديثات. جربه وشارك تجربتك مع المجتمع العربي.
خطة تحديث هذا الدليل
حتى يبقى المرجع صالحاً مع الوقت
- تحقق من تحديثات المستودع على GitHub أسبوعياً.
- تحديث قائمة الوكلاء المدعومة عند إضافة دعم جديد.
- مراجعة الأخطاء الشائعة بناءً على تجارب المستخدمين.
- تحديث قوالب .env إذا تغيرت أسماء المتغيرات.
التعليقات (0)
لا توجد تعليقات بعد. كن أول من يبدأ النقاش 👇