よくある質問

開発者向け GIF ホスティングプラットフォーム AgentGIF についてよくある質問。

AgentGIF とは？

AgentGIF は デュアルレイヤーアーキテクチャ を持つ開発者向け GIF ホスティングプラットフォームです。すべてのターミナルデモ GIF には機械可読な asciinema v2 キャストファイルが対になっているため、人間と AI エージェントの両方がコンテンツを理解できます。

人間にはアニメーションのターミナル録画が表示されます。AI エージェントには構造化データが見えます: コマンド、出力、タイムスタンプ、メタデータ。

AgentGIF は無料ですか？

はい。GIF のアップロード、ホスティング、埋め込みは完全無料です。REST API は認証不要で読み取り操作は無料です。書き込み操作 (アップロード、編集、削除) には 設定ページ からの無料 API キーが必要です。

キャストファイルとは何ですか？

キャストファイルは asciinema v2 録画です。テキスト形式で、1 行目はターミナルメタデータを含む JSON ヘッダーで、その後にタイムスタンプ付きのイベントタプルが続きます:

{"version": 2, "width": 120, "height": 40}
[0.5, "o", "$ docker compose up -d\r\n"]
[1.2, "o", "Creating network...\r\n"]
[2.8, "o", "Container app-1  Started\r\n"]

各タプルは [timestamp_seconds, event_type, data] です。これにより AI エージェントは OCR なしでコマンド、出力、タイミングを抽出できます。

GIF をアップロードするには？

2 つの方法:

  • Web: /upload/ でドラッグ＆ドロップ (GitHub ログインが必要)
  • CLI: agentgif upload demo.gif --title "My Demo" --tags cli,unix

CLI は 5 つの言語 で利用可能: Python、Node.js、Go、Rust、Ruby。--cast demo.cast フラグを含めて機械可読レイヤーを添付してください。

README に GIF を埋め込むには？

GitHub README の推奨パターン:

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

ID を GIF の 8 文字 ID に置き換えてください。すべての 6 つの方法については完全な 埋め込みガイド をご覧ください。

.md エンドポイントとは何ですか？

任意の AgentGIF URL に .md を追加すると、LLM 向けに最適化された text/markdown レスポンスを取得できます。すべてのページがこれをサポートしています — GIF 詳細、タグ一覧、ツールページ、コレクション、ガイド、検索結果。

curl https://agentgif.com/tools/git/.md
curl https://agentgif.com/explore/tags/docker/.md

API キーは必要ですか？

操作認証必要
検索、一覧、詳細、キャスト、トランスクリプト不要 — 完全にオープン
GIF のアップロード、編集、削除必要 — X-API-Key ヘッダー
コレクションの作成/管理必要 — X-API-Key ヘッダー

GitHub でサインインした後、/settings/ で無料 API キーを取得してください。

どのターミナルテーマが利用可能ですか？

AgentGIF はすべての 44 の VHS ターミナルテーマをサポートしています。人気の選択肢:

テーマスタイル
Catppuccin Mochaパステルアクセントのウォームダーク (デフォルト)
Draculaダークパープルクラシック
Tokyo Nightブルー重視のモダンダーク
Nord北極ブルーパレット
Solarized Dark/Light精密カラー
GitHub Dark/LightGitHub のネイティブテーマ

ライブプレビューですべてのテーマを閲覧: テーマギャラリー。

バッジサービスとは何ですか？

AgentGIF は shields.io の代替として ターミナルテーマのパッケージバッジを提供します。選択したターミナルテーマカラーでレンダリングされます。

![PyPI](https://agentgif.com/badge/pypi/requests/version.svg?theme=dracula)
![npm](https://agentgif.com/badge/npm/express/version.svg?theme=nord)
![Stars](https://agentgif.com/badge/github/torvalds/linux/stars.svg)

サポートされているプロバイダー: PyPI、npm、crates.io、GitHub。?theme= と ?style= パラメーターでカスタマイズ。バッジプレイグラウンド をご覧ください。

AI エージェントはどのように GIF を読みますか？

AI エージェントは複数のチャネルを通じて GIF コンテンツにアクセスできます:

  • キャストファイル: GET /api/v1/gifs/{id}/cast/ — タイムスタンプ付きの完全な asciinema v2 録画
  • トランスクリプト: GET /api/v1/gifs/{id}/transcript/ — クリーンなプレーンテキスト、ANSI コードを削除
  • .md エンドポイント: 任意のページ URL に .md を追加して Markdown 出力を取得
  • JSON API: /api/v1/search/?q=docker — 構造化結果による全文検索
  • llms.txt: /llms.txt — AI クローラー向けのサイトレベルサマリー

完全な AI エージェント統合ドキュメント をご覧ください。

どのファイル形式がサポートされていますか？

形式最大サイズ目的
GIF10 MB主要なビジュアル形式 — どこでも再生
Cast (.cast)5 MB機械可読レイヤー (アップロード時は任意)
MP4自動生成効率的な再生の代替

最良の結果を得るには、GIF を 5 MB 未満に保ちます。最適化のヒントは 録画ガイド をご覧ください。

ターミナル GIF を録画するには？

スクリプト化された再現可能な録画には Charm の VHS をお勧めします:

# Install VHS
brew install vhs

# Create a tape file (demo.tape)
Output demo.gif
Set Theme "Catppuccin Mocha"
Type "echo 'Hello, world!'"
Enter
Sleep 2s

# Record
vhs demo.tape

完全なステップバイステップの手順: ターミナル GIF の録画方法。

← について · ドキュメント · ガイド →