Skip to main content

agentgif

CLI for AgentGIF — upload, manage, and share terminal GIFs.

GIF for humans. Cast for agents.

Install

pip install agentgif

Quick Start

# Authenticate via browser
agentgif login

# Upload a GIF
agentgif upload demo.gif --title "My Demo" --command "git commit"

# Record with VHS and upload
agentgif record my-tape.tape

# Search public GIFs
agentgif search "docker compose"

# Get embed codes
agentgif embed <gif-id>

# Generate a terminal-themed badge
agentgif badge url -p pypi -k colorfyi

Commands

Command Description
login Authenticate via browser (device flow)
logout Remove stored credentials
whoami Show current user
upload Upload a GIF (+ optional cast file)
record Run VHS tape → upload GIF
search Search public GIFs
list List your GIFs
info Show GIF details (JSON)
embed Show embed codes
update Update GIF metadata
delete Delete a GIF
badge url Generate a terminal-themed badge URL + embed codes
badge themes List available terminal themes for badges

Badge Commands

# Generate badge for a PyPI package
agentgif badge url -p pypi -k colorfyi

# Markdown format only
agentgif badge url -p npm -k react --format md

# With a theme
agentgif badge url -p crates -k serde --theme dracula

# GitHub stars badge
agentgif badge url -p github -k "vercel/next.js" -m stars

# List available themes
agentgif badge themes

Providers: pypi, npm, crates, github Formats: url, md, html, img, all (default)

License

MIT

Metadata

Release files for agentgif 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for agentgif 0.2.0
File Size Uploaded
agentgif-0.2.0.tar.gz 13.9 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for agentgif 0.2.0
File Interpreter ABI Platform
agentgif-0.2.0-py3-none-any.whl Python 3 none any Details

Total release size: 24.4 kB

Release files / agentgif-0.2.0.tar.gz

Download URL agentgif-0.2.0.tar.gz
Size 13.9 kB
Tags Source
SHA-256 checksum
How to use checksums
064b6dcd7d3e3454fcd29e31f48032a52b6aa07750700d3ede0b3758d3bb2a14
BLAKE2b-256 checksum
How to use checksums
965c6ad417253d83ad20384f1f2c8ffc508b20184be440057d5d7acf8649907a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.10.9 {"installer":{"name":"uv","version":"0.10.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / agentgif-0.2.0-py3-none-any.whl

Download URL agentgif-0.2.0-py3-none-any.whl
Size 10.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1f06c4bd0fedebfc5a223fa025e7e40040db81033540d7d42f34f61655cbe6af
BLAKE2b-256 checksum
How to use checksums
61c9c59abc04689c40043b709f9636501aea20fb99b4ad88ce534075a36ec83f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.10.9 {"installer":{"name":"uv","version":"0.10.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release history Release notifications | RSS feed

This release

0.2.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page