# AgentGIF

> GIF for humans. Cast for agents.

AgentGIF is a developer GIF hosting platform where every GIF has a dual layer:
- Visual layer (GIF image) for humans to watch
- Machine layer (asciinema cast + transcript) for AI agents to read

## API
- GET /api/v1/gifs/ — list all public GIFs
- GET /api/v1/gifs/<id>/ — full GIF metadata + embed codes
- GET /api/v1/gifs/<id>/cast/ — raw asciinema v2 cast data
- GET /api/v1/gifs/<id>/transcript/ — plain text transcript
- GET /api/v1/search/?q=<query> — full-text search
- GET /api/v1/tags/ — all tags
- GET /api/v1/themes/ — terminal theme colors
- GET /api/openapi.json — OpenAPI 3.1 spec

## Search
- /search/ — interactive search with autocomplete
- /explore/search/?q=<query> — server-rendered search results
- /api/v1/search/?q=<query> — JSON search API

## .md Endpoints
Every page has a .md variant: append .md to any URL for text/markdown output.

## Embed
Every GIF can be embedded: Markdown, HTML, iframe, Script, oEmbed, Badge.

## Badges
Terminal-themed package badges at /badge/{pypi,npm,crates,github}/

## Documentation
- /docs/api/ — API reference
- /docs/cli/ — CLI installation
- /docs/embed/ — embed formats
- /docs/agents/ — AI agent integration

## Guides
- /guides/how-to-record-terminal-gif/ — VHS recording tutorial
- /guides/embed-gif-github-readme/ — README embed guide
- /guides/asciinema-vs-agentgif/ — tool comparison
- /guides/ai-agent-readable-gifs/ — machine layer docs

## Pages
- /about/ — about the platform
- /faq/ — frequently asked questions
- /themes/ — terminal theme gallery
- /tools/ — CLI tool directory
- /collections/ — curated GIF collections