agentclip
Turn your AI agent's QA runs into shareable clips.
Your AI agent drives the browser. AgentClip captures the moments that matter, screenshots and captions, and ships you back a single URL anyone can watch.
The product is the artifact (the clip URL) plus the prompt engineering (the bundled skill) that makes generated runs actually good. The backend, MCP plumbing, and CLI are commodity.
Live demo: https://agentclip.dev
Status
Built in May 2026. Early. APIs may shift before a 1.0 tag.
Install
pip install agentclip
That's it. The first time agentclip runs, lazy first-run setup wires the bundled Claude Code skill, downloads browser drivers if you'll need them, and writes a marker so subsequent invocations are instant.
Or run with no install:
uvx agentclip --help
60-second example
Ask your agent in plain English (Claude Code, Claude Desktop, or any MCP-aware client):
QA the signup flow on localhost:3000 and post a clip.
The agent calls slideshow_create, captures screenshots after each meaningful action, calls add_slide with active-voice captions, then set_summary at the end. You get back a share URL plus an edit URL for caption fixes later.
Or use the CLI directly:
agentclip slideshow create --title "Signup QA" --description "fresh-user flow"
agentclip slideshow add <slideshow_id> /tmp/shot1.png --caption "Clicked Sign Up. Form posted."
agentclip slideshow summary <slideshow_id> "Signup passed. One real bug at slide 4."
# Manage what you've made:
agentclip slideshow list
agentclip slideshow delete <slideshow_id>
MCP install (Claude Desktop, Claude Code, Cursor)
Add to your claude_desktop_config.json (or equivalent):
{
"mcpServers": {
"agentclip": {
"command": "uvx",
"args": ["agentclip-mcp"]
}
}
}
Restart your agent runtime. The four tools below will register automatically.
Tools
| Tool | Description |
|---|---|
slideshow_create |
Start a clip. Returns id, share URL, and a write_token used for subsequent mutations. |
slideshow_add_slide |
Append a screenshot + caption. The local state store auto-supplies the write_token. |
slideshow_update_slide |
Replace the image and/or caption of a slide already in the clip. |
slideshow_set_summary |
Set the clip's TL;DR, near the end of the run. |
Configuration
| Env var | Purpose | Default |
|---|---|---|
AGENTCLIP_BASE_URL |
Backend URL. Override for self-hosted. | https://agentclip.dev |
AGENTCLIP_STATE_PATH |
Write-token cache file. | ~/.agentclip/state.json |
Layout
src/agentclip/sdk.py:AgentClipClient, sync HTTP client overhttpxsrc/agentclip/cli.py:agentclip ...Typer CLI, thin wrapper over the SDKsrc/agentclip/mcp_server.py: MCP server registering the four toolssrc/agentclip/state.py: atomic-write~/.agentclip/state.jsonfor write_tokenssrc/agentclip/skill/SKILL.md: the bundled agent skill
Self-hosting the backend
Companion repo: ericelizes1/agentclip — the platform monorepo with the Django API and Next.js frontend. Reference deploy is Fly.io apps + Neon Postgres + Cloudflare R2 object storage, with secrets sourced from 1Password; docker compose up --build covers any Docker host. Point AGENTCLIP_BASE_URL at your domain. Full guide at docs.agentclip.dev/self-hosting.
Development
uv sync --all-extras --dev
uv run pytest -q
uv run ruff check .
See CONTRIBUTING.md for the contributor guide. CI runs lint + format + tests across Python 3.11/3.12/3.13 on every PR.
License
MIT. See LICENSE.
Metadata
Release files for agentclip 0.3.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| agentclip-0.3.2.tar.gz | 98.6 kB | With provenance | Details for agentclip-0.3.2.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| agentclip-0.3.2-py3-none-any.whl | Python 3 | none | any | Details for agentclip-0.3.2-py3-none-any.whl |
Total release size: 133.6 kB
Release files / agentclip-0.3.2.tar.gz
| Download URL | agentclip-0.3.2.tar.gz |
|---|---|
| Size | 98.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
a99ce4bb11f3a12f406e8f76eda57c8cec6c860910fe65067df65401f5779b53
|
|
BLAKE2b-256 checksum How to use checksums |
a27b3b97d644050a3c34c5a092a2273485ab01012d27eb7f70f458cb68e17435
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on May 8, 2026.
Transparency logRelease files / agentclip-0.3.2-py3-none-any.whl
| Download URL | agentclip-0.3.2-py3-none-any.whl |
|---|---|
| Size | 35.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
74ffa7d794db9e76f313849659a7ebaf07e8fd17e3d51091bbd7f85462577a64
|
|
BLAKE2b-256 checksum How to use checksums |
6012eb40fc53498f2c125a0a8ef8128f703b4d00e98b55634fb2c70d3ca20c52
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on May 8, 2026.
Transparency logSecurity for agentclip 0.3.2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for agentclip-0.3.2.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on May 8, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.