CLI Kurulumu ve Kullanımı

AgentGIF CLI, terminal GIF'lerini terminalinizden yüklemenize, kaydetmenize, aramanıza ve yönetmenize olanak tanır. 5 dilde mevcuttur — yığınınıza uyanını seçin.

Kur

CLI tüm büyük paket kayıtçılarında yayınlanmıştır. Her uygulama aynı temel komutları sunar.

Dil	Kurulum Komutu	Kayıtçı
Python	`pip install agentgif`	PyPI
Node.js	`npm install -g @agentgif/cli`	npm
Go	`go install github.com/agentgif/cli@latest`	pkg.go.dev
Rust	`cargo install agentgif`	crates.io
Ruby	`gem install agentgif`	RubyGems

Kurulumu doğrulayın:

agentgif --version
agentgif --help

Kimlik Doğrulama

GIF yüklemeden veya yönetmeden önce GitHub hesabınızla kimlik doğrulaması yapın:

agentgif login

Bu, GitHub OAuth için tarayıcınızı açar. Yetkilendirmeden sonra CLI, API anahtarınızı ~/.config/agentgif/config.json konumunda yerel olarak saklar.

Alternatif olarak, API anahtarınızı doğrudan ayarlayın:

agentgif login --api-key YOUR_API_KEY

Get your API key from Settings → API Key.

Kimlik doğrulama durumunuzu kontrol edin:

agentgif whoami
# → @yourname (authenticated)

Yükle

Meta verilerle bir GIF yükleyin:

agentgif upload demo.gif \
  --title "Docker Compose Up" \
  --command "docker compose up -d" \
  --tags docker,compose,containers \
  --description "Starting services with Docker Compose"

Yükleme Seçenekleri

Bayrak	Açıklama
`--title`	GIF başlığı (gerekli)
`--command`	Gösterilen komut
`--tags`	Virgülle ayrılmış etiketler
`--description`	Açıklama metni
`--cast`	Asciinema v2 cast dosyasının yolu
`--shell`	Kullanılan kabuk (bash, zsh, fish)
`--visibility`	`public` (varsayılan) veya `unlisted`
`--open`	Yüklemeden sonra GIF sayfasını tarayıcınızda açın

Cast Dosyası ile Yükle

Bir cast dosyası eklemek, yapay zeka ajanları için makine tarafından okunabilir katmanı etkinleştirir:

agentgif upload demo.gif --cast demo.cast --title "Git Rebase" --tags git

VHS ile Kaydet

The Python CLI can record terminal sessions directly using VHS (must be installed separately).

# Record from a VHS tape file
agentgif record demo.tape --theme dracula

# Record and immediately upload
agentgif record demo.tape --upload --title "My Demo" --tags demo

Kayıt Seçenekleri

Bayrak	Açıklama
`--theme`	Terminal theme (see themes)
`--output`	Çıktı dosya yolu (varsayılan: tape ile aynı isimde .gif)
`--upload`	Kayıttan hemen sonra yükle
`--title`	Otomatik yükleme için başlık
`--tags`	Otomatik yükleme için etiketler

VHS must be installed separately: brew install vhs (macOS) or see the recording guide.

Arama

Tüm herkese açık GIF'ler arasında arayın:

agentgif search "docker compose"

Çıktı, biçimlendirilmiş bir tabloda GIF kimliği, başlık, komut ve görüntülenme sayısını gösterir.

Arama Filtreleri

# Filter by tag
agentgif search "build" --tag docker

# Filter by shell
agentgif search "alias" --shell zsh

# Sort by views instead of relevance
agentgif search "git" --sort views

GIF'leri Yönet

GIF'lerinizi Listeleyin

agentgif list
agentgif list --limit 50

GIF Detaylarını Görüntüle

agentgif info xK9mQ2pL

GIF Düzenle

agentgif edit xK9mQ2pL --title "New Title" --tags git,rebase

GIF Sil

agentgif delete xK9mQ2pL
# → Are you sure? (y/N)

Yapılandırma

CLI, yapılandırmayı ~/.config/agentgif/config.json konumunda saklar:

{
  "api_key": "ag_xxxxxxxxxxxx",
  "api_url": "https://agentgif.com/api/v1",
  "default_theme": "catppuccin-mocha",
  "default_shell": "zsh",
  "auto_open": false
}

Ortam Değişkenleri

Ortam değişkenleri yapılandırma dosyası ayarlarını geçersiz kılar:

Değişken	Açıklama
`AGENTGIF_API_KEY`	API anahtarı (yapılandırmayı geçersiz kılar)
`AGENTGIF_API_URL`	API temel URL'si
`AGENTGIF_THEME`	Varsayılan VHS teması

CI/CD iş akışlarında kullanışlıdır:

AGENTGIF_API_KEY=${{ secrets.AGENTGIF_KEY }} agentgif upload dist/demo.gif --title "CI Build"

← Dokümantasyona Geri Dön · Gömme Kılavuzu →