Skip to main content

agentclip

Turn your AI agent's QA runs into shareable clips.

PyPI Python CI License: MIT

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 over httpx
  • src/agentclip/cli.py: agentclip ... Typer CLI, thin wrapper over the SDK
  • src/agentclip/mcp_server.py: MCP server registering the four tools
  • src/agentclip/state.py: atomic-write ~/.agentclip/state.json for write_tokens
  • src/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)

Source distribution for agentclip 0.3.2
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)

Table of built distributions (wheels) for agentclip 0.3.2
File Interpreter ABI Platform Actions
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 log

Release 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 log

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

Select from 2 files

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 log

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

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