asciinema vs AgentGIF — Terminal Recording Comparison

Comparison of asciinema and AgentGIF for terminal recording: features, formats, embedding, and AI agent support.

نظرة عامة

asciinema is a terminal session recorder that captures input/output as lightweight text-based recordings (.cast files). It's open-source, self-hostable, and has been the standard for terminal recording since 2012.

AgentGIF is a developer GIF hosting platform with a dual-layer architecture: every GIF has a visual layer (GIF image) for humans and a machine layer (cast + transcript) for AI agents. It uses VHS for recording and serves both GIF images and structured data.

مقارنة الميزات

الميزةasciinemaAgentGIF
التسجيلالتقاط مباشر للطرفيةمُبرمَج عبر ملفات VHS tape
صيغة المخرجات.cast (نصي).gif + .mp4 + .cast
المعاينة المرئيةيتطلب مشغّل JavaScriptGIF مباشر يُشغَّل في كل مكان
GitHub READMEرابط لمشغّل خارجيوسم <img> مباشر
حجم الملفصغير جداً (نطاق KB)متوسط (100 KB – 5 MB)
جودة التشغيلمثالي (نص متجه)جيد (بكسل نقطي)
النسخ من الطرفيةنعم (قابل للتحديد النصي)لا (صورة)
الثيماتعبر إعدادات المشغّل44 ثيم VHS مدمج
دعم وكيل الذكاء الاصطناعيملف cast فقطCast + نص + .md + JSON API
البحثالعنوان فقطكامل النص (العنوان، الأمر، النص، الوسوم)
استضافة ذاتيةنعم (asciinema-server)لا (منصة مستضافة)
مفتوح المصدرنعم (GPL-3.0)لا (خدمة مستضافة)
APIمحدود30+ نقطة نهاية REST + OpenAPI
طرق التضمينiframe، مشغّل JavaScriptMarkdown، HTML، iframe، oEmbed، شارة، Script
خدمة الشاراتلاشارات SVG بثيم الطرفية

التسجيل

asciinema: التقاط مباشر

يُسجِّل asciinema جلسة طرفيتك الفعلية في الوقت الفعلي:

asciinema rec demo.cast
# ... type commands naturally ...
# Press Ctrl+D to stop

المزايا: كتابة طبيعية، يلتقط المخرجات الحقيقية بما في ذلك الأخطاء. العيوب: غير قابل للتكرار — كل تسجيل فريد.

AgentGIF: التسجيل المبرمج

يستخدم AgentGIF ملفات VHS tape — تسجيلات مبرمجة تنتج مخرجات متطابقة في كل مرة:

# demo.tape
Output demo.gif
Set Theme "Catppuccin Mocha"
Type "docker compose up -d"
Enter
Sleep 3s

المزايا: قابل للتكرار وللتحكم بالإصدار، مثالي لـ CI/CD. العيوب: يتطلب كتابة سكريبت.

صيغ المخرجات

الصيغةasciinemaAgentGIFملاحظات
.castأساسيمدعومنصي، حجم صغير جداً، جودة مثالية
.gifعبر التحويلأساسيعرض عالمي، لا يلزم مشغّل
.mp4عبر التحويلمولَّد تلقائياًأصغر من GIF، يلزم مشغّل فيديو
.svgعبر aggشارات فقطجودة متجهية

التضمين في GitHub README

asciinema

تسجيلات asciinema تتطلب مشغّل JavaScript. نظراً لأن GitHub يحذف السكريبتات، يقتصر الأمر على إنشاء رابط:

[![asciicast](https://asciinema.org/a/12345.svg)](https://asciinema.org/a/12345)

يُظهر هذا معاينة SVG ثابتة تشير إلى صفحة مشغّل asciinema.

AgentGIF

تُعرض صور GIF مباشرةً دون أي مشغّل:

<p align="center">
  <img src="https://media.agentgif.com/ID.gif" alt="demo" width="800">
</p>

يُشغَّل العرض التوضيحي تلقائياً — لا يلزم نقر ولا زيارة صفحة خارجية.

دعم وكيل الذكاء الاصطناعي

هنا يتباين المنصتان بشكل أكبر:

القدرةasciinemaAgentGIF
بيانات قابلة للقراءة آلياًملف .cast.cast + نص + JSON API + .md
البحث النصي الكامللانعم (الأوامر، المخرجات، الوسوم)
بيانات وصفية منظمةالعنوان، الأمرالعنوان، الأمر، الوسوم، الأداة، الثيم، الأبعاد
مخرجات محسّنة للنماذج اللغوية الكبيرةلانقاط نهاية .md في كل صفحة
ملخص على مستوى الموقعلاllms.txt
مواصفة OpenAPIلاOpenAPI 3.1 الكامل

الاستضافة

الجانبasciinemaAgentGIF
خيار الاستضافة الذاتيةنعم (asciinema-server)لا
منصة مستضافةasciinema.orgagentgif.com
توصيل CDNasciinema CDNCloudflare R2 (media.agentgif.com)
التسعيرمجاني (مستضاف) / تكاليف الاستضافة الذاتيةمجاني

متى تستخدم كلاً منهما

اختر asciinema عندما:

اختر AgentGIF عندما:

استخدامهما معاً

asciinema و AgentGIF متكاملان. سير عمل شائع:

  1. سجّل باستخدام asciinema للتفاعل الطبيعي: asciinema rec demo.cast
  2. حوّل إلى GIF باستخدام agg أو VHS: agg demo.cast demo.gif
  3. ارفع إلى AgentGIF مع ملف cast: agentgif upload demo.gif --cast demo.cast
  4. ضمّن التسجيل في README الخاص بك (طبقة مرئية للبشر، طبقة cast للوكلاء)

← جميع الأدلة · تسجيلات GIF القابلة للقراءة بواسطة الوكيل الذكي →