asciinema vs AgentGIF — Terminal Recording Comparison
Comparison of asciinema and AgentGIF for terminal recording: features, formats, embedding, and AI agent support.
Genel Bakış
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.
Özellik Karşılaştırması
| Özellik | asciinema | AgentGIF |
|---|---|---|
| Kayıt | Canlı terminal yakalama | VHS tape dosyaları ile betiklenmiş |
| Çıktı Formatı | .cast (metin tabanlı) | .gif + .mp4 + .cast |
| Görsel Önizleme | JavaScript oynatıcısı gerektirir | Satır içi GIF her yerde oynatılır |
| GitHub README | Harici oynatıcıya bağlantı | Satır içi <img> etiketi |
| Dosya Boyutu | Çok küçük (KB aralığında) | Orta (100 KB – 5 MB) |
| Oynatma Kalitesi | Mükemmel (vektör metin) | İyi (rasterleştirilmiş pikseller) |
| Terminalden Kopyala | Evet (metin seçilebilir) | Hayır (görüntü) |
| Temalar | Oynatıcı ayarları aracılığıyla | 44 yerleşik VHS teması |
| Yapay Zeka Ajanı Desteği | Yalnızca cast dosyası | Cast + döküm + .md + JSON API |
| Arama | Yalnızca başlık | Tam metin (başlık, komut, döküm, etiketler) |
| Kendi sunucusunda barındırma | Evet (asciinema-server) | Hayır (barındırılan platform) |
| Açık Kaynak | Evet (GPL-3.0) | Hayır (barındırılan hizmet) |
| API | Sınırlı | 30'dan fazla REST endpoint'i + OpenAPI |
| Gömme Yöntemleri | iframe, JavaScript oynatıcısı | Markdown, HTML, iframe, oEmbed, Badge, Script |
| Rozet Servisi | Hayır | Terminal temalı SVG rozetleri |
Kayıt
asciinema: Canlı Yakalama
asciinema, gerçek terminal oturumunuzu gerçek zamanlı olarak kaydeder:
asciinema rec demo.cast
# ... type commands naturally ...
# Press Ctrl+D to stopArtıları: Doğal yazma, hatalar dahil gerçek çıktıyı yakalar. Eksileri: Yeniden üretilemez — her kayıt benzersizdir.
AgentGIF: Betiklenmiş Kayıt
AgentGIF, VHS tape dosyalarını kullanır — her seferinde aynı çıktıyı üreten betiklenmiş kayıtlar:
# demo.tape
Output demo.gif
Set Theme "Catppuccin Mocha"
Type "docker compose up -d"
Enter
Sleep 3sArtıları: Yeniden üretilebilir, sürüm kontrolü yapılabilir, CI/CD için mükemmel. Eksileri: Betik yazmayı gerektirir.
Çıktı Formatları
| Format | asciinema | AgentGIF | Notlar |
|---|---|---|---|
| .cast | Birincil | Desteklenen | Metin tabanlı, çok küçük boyut, mükemmel kalite |
| .gif | Dönüştürme yoluyla | Birincil | Evrensel görüntüleme, oynatıcı gerekmez |
| .mp4 | Dönüştürme yoluyla | Otomatik oluşturulan | GIF'ten küçük, video oynatıcısı gerekli |
| .svg | agg aracılığıyla | Yalnızca rozetler | Vektör kalitesi |
GitHub README'ye Gömme
asciinema
asciinema kayıtları bir JavaScript oynatıcısı gerektirir. GitHub betikleri kaldırdığından, bağlantı vermekle sınırlısınız:
[](https://asciinema.org/a/12345)Bu, asciinema oynatıcı sayfasına bağlanan statik bir SVG önizlemesi gösterir.
AgentGIF
GIF görüntüleri herhangi bir oynatıcı olmadan satır içi görüntülenir:
<p align="center">
<img src="https://media.agentgif.com/ID.gif" alt="demo" width="800">
</p>Demo otomatik olarak oynatılır — tıklama gerekmez, harici sayfa ziyareti gerekmez.
Yapay Zeka Ajanı Desteği
İki platformun en belirgin şekilde ayrıştığı yer burasıdır:
| Yetenek | asciinema | AgentGIF |
|---|---|---|
| Makine tarafından okunabilir veri | .cast dosyası | .cast + döküm + JSON API + .md |
| Tam metin arama | Hayır | Evet (komutlar, çıktı, etiketler) |
| Yapılandırılmış meta veri | Başlık, komut | Başlık, komut, etiketler, araç, tema, boyutlar |
| LLM için optimize edilmiş çıktı | Hayır | Her sayfada .md endpoint'leri |
| Site düzeyinde özet | Hayır | llms.txt |
| OpenAPI spesifikasyonu | Hayır | Tam OpenAPI 3.1 |
Barındırma
| Boyut | asciinema | AgentGIF |
|---|---|---|
| Kendi sunucusunda barındırma seçeneği | Evet (asciinema-server) | Hayır |
| Barındırılan platform | asciinema.org | agentgif.com |
| CDN dağıtımı | asciinema CDN | Cloudflare R2 (media.agentgif.com) |
| Fiyatlandırma | Ücretsiz (barındırılan) / Kendi sunucu maliyetleri | Ücretsiz |
Her Birini Ne Zaman Kullanmalı
Şu durumlarda asciinema'yı seçin:
- Gerçek terminal oturumlarının canlı kaydına ihtiyacınız var
- Metin seçilebilir çıktı istiyorsunuz (izleyiciler komutları kopyalayabilir)
- Uyumluluk veya gizlilik için kendi sunucunuzda barındırmaya ihtiyacınız var
- Dosya boyutu kritik öneme sahip (cast dosyaları kat kat daha küçüktür)
- Mükemmel vektör kalitesinde oynatma istiyorsunuz
Şu durumlarda AgentGIF'i seçin:
- GitHub README dosyalarında satır içi GIF görüntülemeye ihtiyacınız var
- Yeniden üretilebilir, betiklenmiş demolar istiyorsunuz
- Yapay zeka ajanı desteğine ihtiyacınız var (cast + döküm + API + .md)
- Projenizin görünümüne uygun temalı kayıtlar istiyorsunuz
- Gömme esnekliğine ihtiyacınız var (Markdown, oEmbed, rozetler)
- Terminal temalı paket rozetleri istiyorsunuz
İkisini Birlikte Kullanma
asciinema ve AgentGIF birbirini tamamlar. Yaygın bir iş akışı:
- Doğal etkileşim için asciinema ile kaydedin:
asciinema rec demo.cast - agg veya VHS kullanarak GIF'e dönüştürün:
agg demo.cast demo.gif - Cast dosyasıyla AgentGIF'e yükleyin:
agentgif upload demo.gif --cast demo.cast - GIF'i README'nize gömün (insanlar için görsel katman, ajanlar için cast katmanı)