자주 묻는 질문

개발자용 GIF 호스팅 플랫폼 AgentGIF에 관한 일반적인 질문.

AgentGIF이란?

AgentGIF은 이중 레이어 아키텍처를 갖춘 개발자용 GIF 호스팅 플랫폼입니다. 모든 터미널 데모 GIF는 기계 판독 가능한 asciinema v2 cast 파일과 짝을 이루어, 사람과 AI 에이전트 모두 콘텐츠를 이해할 수 있습니다.

사람은 애니메이션 터미널 녹화를 봅니다. AI 에이전트는 구조화된 데이터를 봅니다: 명령어, 출력, 타임스탬프, 메타데이터.

AgentGIF은 무료인가요?

예. GIF 업로드, 호스팅, 임베딩은 완전히 무료입니다. REST API는 인증 없이 읽기 작업에 무료입니다. 쓰기 작업(업로드, 편집, 삭제)은 설정 페이지에서 무료 API 키가 필요합니다.

cast 파일이란 무엇인가요?

cast 파일은 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를 어떻게 업로드하나요?

두 가지 옵션:

  • 웹: /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 키가 필요한가요?

작업인증 필요
검색, 목록, 상세, cast, 전사본아니오 — 완전히 개방
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의 기본 테마

실시간 미리보기로 모든 테마 탐색: 테마 갤러리.

Badge 서비스란 무엇인가요?

AgentGIF은 shields.io 대안으로 터미널 테마 패키지 Badge를 제공합니다. 선택한 터미널 테마 색상으로 렌더링됩니다.

![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= 파라미터로 커스터마이즈하세요. Badge 놀이터를 참조하세요.

AI 에이전트는 어떻게 GIF를 읽나요?

AI 에이전트는 여러 채널을 통해 GIF 콘텐츠에 접근할 수 있습니다:

  • Cast 파일: GET /api/v1/gifs/{id}/cast/ — 타임스탬프가 있는 전체 asciinema v2 녹화
  • 전사본: GET /api/v1/gifs/{id}/transcript/ — ANSI 코드가 제거된 깔끔한 일반 텍스트
  • .md 엔드포인트: Markdown 출력을 위해 모든 페이지 URL에 .md를 추가하세요
  • 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 녹화 방법.

← 소개 · 문서 · 가이드 →