Discover tools that actually ship. Curated product discovery for developers, PMs, and founders.

Product

Today's Launches
Weekly Picks
Leaderboard
Categories
AI Recommendations

Community

Submit a Product
Top Makers
Top Reviewers

Resources

Blog
Guides
Trends
API Documentation

Company

About
Newsletter
Privacy Policy
Terms of Service

Stay in the loop

Get the best new tools delivered to your inbox weekly.

uploads.sh — The missing upload command for coding agents | LaunchDaily

Home
/
Developer Tools
/
uploads.sh

uploads.sh

The missing upload command for coding agents

uploads.sh is a CLI tool that solves the problem of coding agents not being able to easily show their work in GitHub pull requests. It automatically captures and stages screenshots on the current branch, so when a PR is opened, a single comment with all attachments appears without extra commands. Designed for AI coding agents and developers, it integrates with GitHub and works via npm install.

Key Features

Auto-staging on branches

Running uploads put on a branch stages screenshots automatically — no --branch flag or PR needed yet.

Preview staged uploads

Use uploads staged to see what's queued and whether it will auto-attach; re-running updates the same comment instead of adding a new one.

Automatic PR attachment

When you create a PR via gh pr create or GitHub UI, staged files promote automatically into a single attachments comment.

Direct attach to existing PRs/issues

Use uploads attach to immediately attach screenshots to an already open pull request or issue.

Metadata tagging and search

Tag uploads with --meta key=value (e.g. --meta path=/settings) and later retrieve them with uploads find.

One-shot screenshots

uploads screenshot <url> captures a page and hosts it in one step, supporting both local and remote browsers.

Device frames

Wrap a raw screenshot in device chrome (phone, browser, specific iPhone) using the --frame option.

Shareable galleries

Group uploads into a gallery that can span multiple PRs, providing one link for the whole set with linked issues and pull requests.

Use Cases

Coding agents capturing screenshots at each milestone during development
Developers staging screenshots on a branch before opening a PR
PR reviewers seeing a single attachments comment with all relevant screenshots
Teams tagging screenshots by path or feature to easily find them later
Quickly attaching screenshots to an already open PR or issue
Creating device-framed screenshots for mobile or browser views
Grouping related screenshots across multiple PRs into a gallery
Setting up an agent workflow to automatically capture UI changes

FAQ

Is uploads.sh free to use?

The page states it is 'free to start in the cloud' and 'open source to self-host', indicating a free tier is available.

How does the automatic PR attachment work?

When you run uploads put on a branch, the file is staged. When you later open a PR using gh pr create or the GitHub UI, the staged files promote automatically into a single attachments comment.

Do I need to install the GitHub App?

No, the CLI works without the GitHub App. The App is optional and allows comments to post as the uploads-sh bot and staged screenshots to promote themselves when the PR opens.

Can I attach screenshots to an existing PR?

Yes, use the uploads attach command to target an already open PR or issue immediately.

How do I find previously uploaded screenshots?

Tag your uploads with --meta key=value when uploading. Later, use uploads find with the key/value to retrieve them.

Can I capture screenshots of remote URLs?

Yes, the uploads screenshot command accepts a URL and captures it in one step, supporting both local and remote browsers.