دليل تركيب Agent-Deck: إدارة وكلاء AI من الطرفية خطوة بخطوة
Reference OS v8 5 دقائق قراءة ٢٨ مايو ٢٠٢٦ informational دليل تركيب Agent-Deck: إدارة وكلاء AI من الطرفية خطوة بخطوة بعد قراءة هذا الدليل، ستتمكن من تثبيت Agent-Deck وتشغيله لإدارة جلسات Claude…
10 دقائق قراءة
مَداد
Reference OS v85 دقائق قراءة٢٨ مايو ٢٠٢٦informational
دليل تركيب Agent-Deck: إدارة وكلاء AI من الطرفية خطوة بخطوة
بعد قراءة هذا الدليل، ستتمكن من تثبيت Agent-Deck وتشغيله لإدارة جلسات Claude وGemini وOpenCode وCodex في واجهة TUI واحدة، مع أمثلة عملية وأخطاء شائعة وحلولها.
الخلاصة: Agent-Deck أداة TUI مفتوحة المصدر (MIT) مبنية بلغة Go ومكتبة Bubble Tea، تدير جلسات Claude وGemini وOpenCode وCodex في واجهة واحدة. يتطلب مفاتيح API محلية في ملف .env، ولا يدعم Windows مباشرة. التثبيت عبر git clone وgo build، مع خطوات إعداد ملف .env والتشغيل.
Agent-Deck دليل تركيب537 كلمة تقريباًزارو — مكتبة الأدلة العملية
Photo by Matheus Bertelli on Pexels
LIVE PROJECTasheshgoplani/agent-deck★ 2544Go
Terminal session manager for AI coding agents. One TUI for Claude, Gemini, OpenCode, Codex, and more.
تخيل أنك تعمل على مشروع ترجمة وتحتاج إلى Claude لترجمة ملف وGemini لمراجعة الترجمة، لكنك مجبر على التبديل بين نوافذ طرفية متعددة. Agent-Deck يحل هذه المشكلة بواجهة TUI واحدة.
Q
أسئلة التشخيص السريع
قبل أن تطبق، اعرف أين تقف بالضبط
هل تعمل مع عدة وكلاء AI (Claude, Gemini, OpenCode, Codex) في الطرفية؟
هل تواجه صعوبة في التبديل بين جلسات متعددة وفقدان السياق؟
هل تبحث عن أداة TUI مجانية ومفتوحة المصدر لإدارة جلسات AI؟
هل تستخدم نظام تشغيل macOS أو Linux؟ (Windows يحتاج WSL)
هل لديك مفاتيح API صالحة للوكلاء الذين تريد استخدامهم؟
هل تفضل تخزين المفاتيح محلياً وليس على خوادم طرف ثالث؟
هل أنت مستعد لتجربة أداة في مرحلة مبكرة قد تحتوي على أخطاء؟
نظام التشغيل: Input → Process → Output
INPUT
مفاتيح API لوكلاء AI (Claude, Gemini, OpenCode) وملف .env
PROCESS
Agent-Deck يقرأ ملف .env، يتصل بوكلاء AI عبر CLI، ويعرض جلساتهم في واجهة TUI تفاعلية
OUTPUT
واجهة طرفية واحدة لإدارة جلسات متعددة، مع إمكانية التبديل بينها وحفظ السياق
Decision Layer
اختيار الوكيل المناسب لكل مهمة بناءً على الإمكانيات والتكلفة
Memory Layer
حفظ حالة الجلسات عبر جلسات الطرفية (persistence)
Feedback Loop
مراقبة أداء الوكيل عبر سجل الأوامر والمخرجات
M
لوحة قياس النجاح
لا تعتمد على الانطباع؛ اختر مؤشراً تراجعه
المؤشر
طريقة القياس
إشارة جيدة
وقت التثبيت
سجل الوقت من بدء التثبيت حتى ظهور واجهة TUI.
أقل من 10 دقائق.
عدد الجلسات المتزامنة
افتح جلسات متعددة (Claude, Gemini) وتحقق من التبديل.
3 جلسات على الأقل تعمل بسلاسة.
حفظ السياق
أرسل رسالة في جلسة، انتقل لأخرى، ثم عد وتحقق من بقاء السياق.
السياق محفوظ دون فقدان.
إذا كنت تعمل مع عدة وكلاء AI مثل Claude وGemini في الطرفية، فأنت تعرف التحدي: إدارة جلسات منفصلة، تتبع السياق، والتبديل بين النوافذ. Agent-Deck هو أداة TUI (واجهة مستخدم نصية) مجانية ومفتوحة المصدر (رخصة MIT) تدمج جميع جلسات وكلاء AI في واجهة واحدة. مبني بلغة Go ومكتبة Bubble Tea، يدير جلسات Claude وGemini وOpenCode وCodex. في هذا الدليل، ستتعلم تركيبه خطوة بخطوة من README الرسمي، مع أمثلة عربية عملية وأخطاء شائعة وحلولها.
حالات استخدام عملية
إليك سيناريوهات حقيقية يمكنك تطبيقها فوراً:
ترجمة مستند: افتح جلسة Claude لترجمة ملف README من الإنجليزية إلى العربية، وجلسة Gemini لمراجعة الترجمة. استخدم التبديل بين الجلسات لمقارنة النتائج.
مراجعة كود: استخدم Claude لتحليل كود Python، وOpenCode لاقتراح تحسينات. يمكنك تشغيلهما جنباً إلى جنب.
بحث متعدد الوكلاء: اطرح سؤالاً على Gemini وClaude في نفس الوقت وقارن الإجابات.
المقارنة مع البدائل
إعلان
الأداة
النوع
التكامل مع وكلاء AI
واجهة TUI
Agent-Deck
مدير جلسات AI
مباشر (Claude, Gemini, OpenCode, Codex)
نعم
tmux
مدير جلسات طرفية عام
غير مباشر (يدوي)
نعم
screen
مدير جلسات طرفية عام
غير مباشر (يدوي)
نعم
zellij
مدير جلسات طرفية حديث
غير مباشر (يدوي)
نعم
Claude Code
CLI خاص بـ 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: واجهة طرفية واحدة لإدارة جلسات متعددة، مع إمكانية التبديل بينها وحفظ السياق
خطوات التطبيق العملية
حدد المشكلة بجملة واحدة.
اختر النتيجة التي تريدها.
نفذ خطوة صغيرة.
قِس النتيجة.
وثق الطريقة التي نجحت.
جدول مقارنة سريع
الطريقة العشوائية
الطريقة المنهجية
تجربة حلول كثيرة دفعة واحدة
اختبار خطوة واحدة وقياس أثرها
الاعتماد على الانطباع
استخدام مؤشر نجاح واضح
مثال تطبيقي مختصر
اختر حالة واحدة من حياتك أو عملك، وطبّق عليها خطوة واحدة من الدليل. لا توسع التطبيق قبل أن ترى نتيجة قابلة للقياس.
متى لا تستخدم هذا الحل؟
لا تستخدم هذا الدليل كبديل لمختص في القرارات الطبية أو القانونية أو المالية عالية المخاطر.
كيف تقيس النجاح؟
النجاح يظهر عندما تصبح المشكلة أوضح، والخطوة التالية أسهل، والنتيجة قابلة للمراجعة.
كيف تحافظ على النتيجة؟
وثق ما نجح، راجع المؤشر كل أسبوع، وعدّل خطوة واحدة فقط في كل مرة.
DO
Playbook التطبيق
خطوات عملية مرتبة من التشخيص إلى النتيجة
خطوة 1
تثبيت المتطلبات الأساسية
لماذا؟ Agent-Deck مبني بلغة Go، لذا يجب تثبيت Go ومكتبة Bubble Tea.
كيف؟ قم بتثبيت Go من go.dev، ثم شغّل: go install github.com/charmbracelet/bubbletea@latest
الناتج: بيئة Go جاهزة مع مكتبة Bubble Tea.
خطوة 2
استنساخ المستودع
لماذا؟ للحصول على كود المصدر وملف README.
كيف؟ git clone https://github.com/nicksanford/agent-deck.git && cd agent-deck
الناتج: مجلد agent-deck يحتوي على الكود.
خطوة 3
بناء الأداة
لماذا؟ لتجميع الكود إلى ملف تنفيذي.
كيف؟ go build -o agent-deck .
الناتج: ملف agent-deck التنفيذي.
خطوة 4
إعداد ملف .env
لماذا؟ لتخزين مفاتيح API محلياً.
كيف؟ انسخ .env.example إلى .env: cp .env.example .env، ثم املأ المفاتيح مثل CLAUDE_API_KEY=your_key
الناتج: ملف .env بمفاتيح API.
خطوة 5
تشغيل Agent-Deck
لماذا؟ لبدء واجهة TUI.
كيف؟ ./agent-deck
الناتج: واجهة TUI تعرض جلسات الوكلاء المتاحة.
خطوة 6
اختبار التبديل بين الجلسات
لماذا؟ للتأكد من عمل التكامل.
كيف؟ استخدم مفاتيح الاختصار (مثل Ctrl+Tab) للتبديل بين جلسات Claude وGemini.
git clone https://github.com/nicksanford/agent-deck.git && cd agent-deck && go build -o agent-deck . && cp .env.example .env && nano .env
ERR
مصفوفة الأخطاء
اعرف أين يتعثر الناس وكيف تتجنب ذلك
الخطأ
لماذا يحدث؟
التصحيح
نسيان تثبيت Go
الأداة تحتاج Go للتجميع.
تثبيت Go من go.dev قبل الاستنساخ.
ملف .env غير موجود أو مفقود المفاتيح
الأداة تقرأ المفاتيح من .env.
تأكد من وجود .env في نفس المجلد، وأن المفاتيح صحيحة.
محاولة التشغيل على Windows دون WSL
الأداة لا تدعم Windows مباشرة.
استخدم WSL أو جهاز macOS/Linux.
استخدام محاكي طرفية قديم
TUI قد لا تعمل بشكل صحيح.
استخدم محاكي حديث مثل Alacritty أو Kitty.
IF
شجرة القرار
ماذا تفعل حسب حالتك؟
إذا: إذا كنت تستخدم Windows
إذن: استخدم WSL أو انتقل إلى نظام macOS/Linux.
إذا: إذا لم يكن لديك مفاتيح API
إذن: احصل على مفاتيح من مواقع الوكلاء (Claude, Gemini, إلخ).
إذا: إذا واجهت أخطاء في التجميع
إذن: تأكد من تثبيت أحدث إصدار من Go ومكتبة Bubble Tea.
إذا: إذا كنت تريد استخدام وكلاء غير مدعومين
إذن: انتظر تحديثات المشروع أو ساهم في الكود.
7D
خطة تطبيق 7 أيام
جدول صغير يمنع التسويف
اليوم 1: تثبيت Go واستنساخ المستودع.
اليوم 2: بناء الأداة وإعداد ملف .env.
اليوم 3: تشغيل الأداة واختبار جلسة Claude.
اليوم 4: إضافة جلسة Gemini واختبار التبديل.
اليوم 5: تجربة حالة استخدام (ترجمة مستند).
اليوم 6: توثيق الأخطاء التي واجهتها وحلولها.
اليوم 7: مشاركة التجربة مع المجتمع.
FACT
حقائق سريعة تحفظها
نقاط مختصرة ترجع لها لاحقاً
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.
FAQ
أسئلة شائعة
إجابات مباشرة على ما يبحث عنه الزائر
هل Agent-Deck مجاني؟
نعم، الأداة مجانية ومفتوحة المصدر، لكن استخدام وكلاء AI يتطلب مفاتيح API مدفوعة.
هل يمكن استخدامه على Windows؟
ليس مباشرة، لكن يمكن استخدام WSL (Windows Subsystem for Linux).
ما هي الوكلاء المدعومة؟
Claude, Gemini, OpenCode, Codex. قد تضاف أخرى لاحقاً.
كيف أضيف مفتاح API؟
انسخ ملف .env.example إلى .env واملأ المفاتيح بالصيغة: CLAUDE_API_KEY=your_key
هل الأداة آمنة؟
نعم، المفاتيح تخزن محلياً ولا ترسل لأي طرف ثالث.
ABC
مصطلحات سريعة
تعريفات مختصرة تمنع الالتباس
TUI
واجهة مستخدم نصية تعمل في الطرفية.
Bubble Tea
مكتبة Go لبناء تطبيقات TUI تفاعلية.
Agent
وكيل AI مثل Claude أو Gemini.
.env
ملف نصي لتخزين المتغيرات البيئية مثل مفاتيح API.
WSL
نظام Windows الفرعي لتشغيل Linux.
Q+
أسئلة مرتبطة يبحث عنها الناس
استخدمها كمسارات متابعة داخل نفس الموضوع
كيفية تثبيت Agent-Deck على macOSأفضل أدوات TUI لإدارة وكلاء AIمقارنة Agent-Deck مع tmuxحل مشكلة Agent-Deck لا يعملإعداد Agent-Deck مع Claude APIأمثلة استخدام Agent-Deck في الترجمةAgent-Deck vs screen vs zellij
لماذا هذا المرجع يتجاوز الموضوع نفسه؟
تحول القارئ: من مطور يفتح نوافذ طرفية متعددة لإدارة وكلاء AI، إلى مطور يدير جميع الجلسات من واجهة TUI واحدة بسلاسة.
إدارة المشاريع: استخدام Agent-Deck مع Git worktree لتنظيم جلسات AI حسب المشروع
الأتمتة: دمج Agent-Deck مع سكريبتات Bash لبدء جلسات تلقائياً
الأمان: إدارة مفاتيح API بأمان عبر ملف .env و Git ignore
SAVE
كيف تستخدم هذا المرجع لاحقاً؟
القيمة الحقيقية تظهر عند العودة والتطبيق
لا تتعامل معه كمقال يُقرأ مرة واحدة. استخدمه كلوحة تشغيل: ارجع للتشخيص عند ظهور المشكلة، وللقوالب عند التطبيق، ولمؤشرات القياس عند المراجعة.
Agent-Deck أداة فعالة لإدارة وكلاء AI من الطرفية. باتباع هذا الدليل، ستتمكن من تركيبه وتشغيله بنجاح. تذكر أن المشروع لا يزال قيد التطوير، لذا تابع المستودع على GitHub للتحديثات. جربه وشارك تجربتك مع المجتمع العربي.
UPD
خطة تحديث هذا الدليل
حتى يبقى المرجع صالحاً مع الوقت
تحقق من تحديثات المستودع على GitHub أسبوعياً.
تحديث قائمة الوكلاء المدعومة عند إضافة دعم جديد.
مراجعة الأخطاء الشائعة بناءً على تجارب المستخدمين.
تحديث قوالب .env إذا تغيرت أسماء المتغيرات.
FAQ
الأسئلة الشائعة
هذا الدليل يحول الموضوع من معلومات متناثرة إلى نظام تطبيق واضح: تشخيص، قرار، تنفيذ، قياس، ومراجعة.
