# 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

## .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.

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