Media Sharing

Product Introduction

1. Definition: Argos Media Sharing is a developer-focused media hosting and sharing API integrated within the Argos CI/CD platform. It is a technical solution for programmatically generating stable, shareable URLs for screenshots, screen recordings, and other visual assets directly from command-line interfaces (CLI), software development kits (SDK), or via its REST API.
2. Core Value Proposition: It exists to solve the critical workflow gap in modern software development, particularly with AI agents and continuous integration (CI), where there is no native GitHub or GitLab API for attaching visual media to pull requests (PRs). Its primary value is enabling automated systems and developers to "show their work" by instantly creating permanent links with ready-to-paste Markdown, which are automatically posted to the relevant code review thread.

Main Features

1. Multi-Protocol Media Upload: The feature supports uploads through a dedicated CLI tool (@argos-ci/cli), language-specific SDKs (like for Playwright), a full REST API (api.argos-ci.com/v2), and an MCP (Model Context Protocol) server for AI agents. This allows integration into any automated workflow, from local scripts to cloud CI runners like GitHub Actions or GitLab CI.
2. Automatic PR Context Attachment: How it works: When media is uploaded and associated with a specific Git branch, the system automatically detects when a pull request is created from that branch. It then posts the generated share link as a comment on the PR, eliminating manual copying and pasting by developers or bots. This ensures visual context is never detached from the code review.
3. Stable Share Links with Embedded Markdown: Upon upload, the service generates a permanent, CDN-hosted URL for the asset. Crucially, it provides the link pre-formatted in Markdown syntax (e.g., ![description](url)), ready for immediate pasting into issue trackers, Slack, documentation, or PR descriptions. This streamlines communication and documentation.

Problems Solved

1. Pain Point: The "blind CI" problem, where automated tests or AI agents generate visual outputs (screenshots, diffs, recordings) but cannot natively attach them to the code review for human verification. This creates friction, slows down review cycles, and leads to context switching.
2. Target Audience: Primary personas include Frontend/QA Engineers using visual testing; DevOps/SREs configuring CI pipelines; AI Agent Developers building coding assistants (like Cline, Sweep, GPT Engineer); and Engineering Teams adopting AI-powered development tools who need audit trails for agent work.
3. Use Cases: An AI agent automatically fixes a UI bug and uses the MCP server to upload a "before and after" screenshot collage to the PR. A Playwright test fails in CI; the @argos-ci/playwright SDK uploads the failure screenshot and trace, with the link posted directly to the failing GitHub check. A developer quickly shares a UI prototype recording from their terminal using argos upload recording.mp4.

Unique Advantages

1. Differentiation: Unlike generic image hosts (Imgur) or file upload services, Argos Media Sharing is deeply integrated with the Git and code review workflow. Unlike simply using CI artifact storage, it provides automatic PR commenting and easy-to-share public URLs without complex permission setup. It is a native feature of a broader visual testing platform, not a standalone tool.
2. Key Innovation: The Git branch-aware media staging system is the core innovation. By tagging uploads with branch metadata, it creates a temporary staging area for visual assets that automatically promotes them to PR comments upon pull request creation. This "fire-and-forget" API model for bots and agents is uniquely suited for AI-driven development.

Frequently Asked Questions (FAQ)

1. How does Argos Media Sharing integrate with AI agents like Cursor or Claude? Argos provides an MCP (Model Context Protocol) server (mcp.argos-ci.com) that allows AI agents to directly upload screenshots and recordings as they work. The agent can then include the generated Markdown link in its PR description or comments, providing visual proof of its changes.
2. Is Argos Media Sharing free to use? The media sharing functionality is included within Argos's pricing tiers. The Hobby plan offers a monthly allowance, making it suitable for personal projects and low-volume usage, while the Pro plan provides higher limits and team features. Detailed pricing is available on the Argos website.
3. Can I use Argos Media Sharing without using Argos Visual Testing? Yes, the media sharing API, CLI, and SDKs can be used as a standalone service for generating shareable links. You can authenticate and upload media without setting up visual testing builds, making it a flexible tool for any screenshot or recording sharing need in a development context.
4. What file formats are supported for upload? The service supports common image formats (PNG, JPG, WebP, GIF) for screenshots and standard video containers (MP4, WebM) for screen recordings, catering to the primary use cases of developers and automated testing tools.
5. How does automatic PR commenting work with private repositories? Argos uses OAuth integration with GitHub and GitLab. When you install the Argos GitHub App or configure the GitLab integration, it receives webhooks for PR events. It then correlates uploaded media from the PR's source branch and posts comments using its authenticated bot user, respecting the repository's visibility settings.