[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_130":131},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module not found","tools","module",{"_20":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":34,"_35":26,"_36":37,"_38":-5,"_39":-5,"_40":41,"_42":43,"_44":45,"_46":47,"_48":49,"_50":51,"_52":53,"_54":55,"_56":57,"_58":-5,"_59":51,"_60":61,"_62":63,"_64":65,"_66":67,"_68":69,"_70":71,"_72":73,"_74":75,"_76":77,"_78":79,"_80":81,"_82":-5,"_83":-5,"_84":-5,"_85":86,"_87":-5,"_88":45,"_89":90,"_91":92,"_93":94,"_95":96,"_97":98,"_99":100},"apiUrl","https://odel.app/api","creator","uploads","moduleId","mcp","@uploads/mcp","displayName","uploads.sh","tagline","Host files from coding agents; stage on a branch and attach to GitHub PRs.","iconKey","external/e904e3641aa725b52d45c60100f7ac3b684014900a69b8d06a2193ec0727b122.png","category","remote","status","published","visibility","public","metaDescription","deploymentType","external","workerName","bindingName","mcpConfig","{\"url\":\"https://agents.uploads.sh/mcp\",\"transport\":\"streamable-http\",\"authType\":\"bearer\"}","pricingModel","free","priceCredits",0,"creatorUserId","system:external-import","createdAt",1787808583000,"updatedAt",1790486218000,"sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=sh.uploads%2Fmcp","sourceVerified",true,"sourceMissingSince","importedAt","upstreamStars",19,"upstreamUpdatedAt",1790467944000,"detectedTransport","streamable-http","detectedAuthType","oauth","probeStatus","ok","lastProbedAt",1790453616000,"githubRepoUrl","https://github.com/buildinternet/uploads","githubRepoFullName","buildinternet/uploads","releaseId","ext-buildinternet-uploads","version","0.56.5","descriptionMarkdown","

\n\n $\"uploads.sh$ \n\n

uploads

\n\n**The missing upload command for coding agents.**\n\nCapture screenshots, recordings, and other artifacts as you work: test\nreports, logs, JSON, PDFs, zips. When the pull request opens, uploads.sh puts\nthem in one tidy comment that updates automatically on each revision. Hosted\nuploads.sh is free to start. Connect your own bucket — Cloudflare R2 or any\nS3-compatible provider — so storage in that bucket is unmetered, or self-host\nthe open-source service.\n\n

\n uploads.sh · \n Docs · \n npm → · \n Quick start · \n What it looks like · \n What's in this repo · \n Develop\n

\n\n

\n $\"skills.sh\"$ \n $\"CI\"$ \n $\"npm$ \n $\"MCP$ \n $\"GitHub$ \n $\"Ask$ \n $\"License:$ \n

\n\n

_{\n Under active development. uploads.sh is being built in the open, so\n APIs can still change. Feedback is welcome — open an issue.\n}

\n\n

\n\n---\n\n## Artifacts ready when the pull request opens\n\n**uploads** hosts the artifacts coding agents produce at stable public URLs\nthey can use in pull requests and issues: screenshots and screen recordings,\nbut also test reports, logs, JSON, CSV, Markdown, PDFs, and zip archives\n(the full list is under [Plans & limits](https://uploads.sh/docs/limits)). On\na branch, `uploads put` stages each file as soon as it is ready. When the pull\nrequest opens, uploads.sh promotes the staged files into one managed comment.\n\nGitHub's own attachments work from a browser and, since GitHub CLI 2.99\n(September 2026), from `gh … --attach`, but only once a pull request or issue\nexists, and the files stay behind GitHub's own hosting, where they cannot be\nembedded or fetched anywhere else. uploads.sh gives agents a stable\npublic URL from the same terminal where they build and test the change, while\nthe branch is still in progress. The hosted MCP server does the same for agents\nthat cannot run a command at all, taking files as bytes or a URL. GitHub has no\npublic API (yet) for that.\n\nKeys are hash-free, so re-uploading the same filename overwrites in place and\nthe URL never changes — every embed of it updates at once. Workspaces keep\ntenants (and their budgets and key policies) apart.\n\nThis repo is the source of the canonical deployment at\n[uploads.sh](https://uploads.sh): the API worker, auth worker, MCP server, the\nAstro web app, and the `@buildinternet/uploads` CLI (published to npm from\n[`packages/uploads`](https://github.com/buildinternet/uploads/blob/main/packages/uploads)).\n\n## What it looks like\n\nOne comment per PR, rewritten in place on every sync. Files tagged\n`--state before` and `--state after` pair into a side-by-side table; other\nimages and video land below it, and non-media files (reports, logs, archives)\nlist in a file table with their type and size.\n\n

\n $\"The$ \n

\n\n_{The real comment on\n[#436](https://github.com/buildinternet/uploads/pull/436#issuecomment-5052307515).}\n\nPairing is by `--meta path=…` when several pairs share a comment (one `before`\nand one `after` per path), and falls back to filenames that differ only by a\n`before`/`after` token — `hero-before.webp` with `hero-after.webp`.\n\nEverything you attach also lands in your workspace, grouped by where it came\nfrom — pages by `path`, projects by `repo` or `app` — and browsable from one\nplace.\n\n

\n $\"The$ \n

\n\n_{The screenshots view groups uploads by project and path.}\n\nOpen any file for a share page: copy-ready embeds (Markdown, HTML, and more),\nthe raw URL, and a delete button.\n\n

\n $\"A$ \n

\n\n_{Each file's share page — copy-ready embeds, details, and delete.}\n\n## Quick start\n\nInstall the CLI and sign in once:\n\n```bash\nnpm install --global @buildinternet/uploads\nuploads login\n```\n\nUpload a file and tag the page it shows:\n\n```bash\nuploads put ./settings.png --meta path=/settings\n```\n\nOn a branch, `put` stages the file automatically. Open the pull request however\nyou normally would. The [GitHub App](https://uploads.sh/docs/github-app)\npromotes the staged files into one managed attachments comment.\n\n## More ways to upload\n\nUse the same commands for before-and-after evidence, an open pull request, a\nbrowser capture, or an annotated image:\n\n```bash\n# Pair two states from the same page in the pull request comment.\nuploads put ./before.png --meta path=/settings --state before\nuploads put ./after.png --meta path=/settings --state after\n\n# See what this branch will attach when the pull request opens.\nuploads staged\n\n# Attach files directly when a pull request or issue is already open.\nuploads attach ./before.png ./after.png\n\n# Capture, annotate, and upload a page in one command.\nuploads screenshot http://localhost:4321/settings --via local --annotate ./callouts.json\n```\n\n`attach` detects the repository and current PR through `gh`, uploads all files,\nand creates or updates that same one comment. Without the GitHub App, run\n`uploads attach --promote` after opening the pull request to promote files that\nyou staged earlier. All commands run under `npx @buildinternet/uploads …`\nwithout a global install.\n\nSign in with GitHub or a magic link, then create your own workspace or accept\nan invite into one — see [enrollment](https://github.com/buildinternet/uploads/blob/main/docs/enrollment.md). Hosted files are\npublic URLs — private-repo attachments get non-guessable links\n([how that works](https://github.com/buildinternet/uploads/blob/main/docs/private-attachments.md)), but anyone holding a URL can\nview the file. Do not upload secrets or sensitive UI.\n\n## Connect your agent\n\nThe hosted MCP server runs at `https://agents.uploads.sh/mcp` and is listed in the\n[MCP Registry](https://registry.modelcontextprotocol.io/v0.1/servers?search=sh.uploads/mcp)\nas `sh.uploads/mcp`. Local stdio is `uploads mcp` on the same npm package.\n\n```bash\n# Claude Code\nclaude mcp add --transport http uploads https://agents.uploads.sh/mcp\n\n# Codex\ncodex mcp add uploads --url https://agents.uploads.sh/mcp\n\n# OpenCode\nopencode mcp add uploads --url https://agents.uploads.sh/mcp\n```\n\n`uploads install` adds the agent skills and the MCP server, so future sessions\ncan capture each visual milestone without being asked. The skills also install\nstandalone into any agent runtime:\n\n```bash\nnpx skills add buildinternet/uploads\n```\n\nThat installs three skills: `github-screenshots` (visuals → PRs/issues),\n`uploads-cli` (full CLI reference), and `annotate-screenshots` (callouts and\nredaction on a capture).\n\nOn Claude Code or Codex, the [plugin](https://uploads.sh/docs/agents#plugin)\nbundles the skills, the MCP server, and a pre-PR screenshot reminder.\n\nFull CLI usage, including annotations, managed comments, public galleries,\nand change feeds (repo-wide or one pull request), lives in\n[docs/cli.md](https://github.com/buildinternet/uploads/blob/main/docs/cli.md).\n\n`uploads feed create` prints a live page of the screenshots on a repo:\n\n

\n $\"Terminal$ \n

\n\n_{`uploads feed create --repo buildinternet/uploads`.}\n\nREST routes are in [docs/api.md](https://github.com/buildinternet/uploads/blob/main/docs/api.md).\n\n## What's in this repo\n\n| Path | What |\n| --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `apps/` | The deployables: the REST API worker (`api.uploads.sh`), the auth worker, the remote MCP server, and the Astro site at uploads.sh |\n| `packages/` | Shared code — most notably `@buildinternet/uploads` (the CLI, published to npm), `@uploads/storage` (the files-sdk adapter factory all storage goes through), and `@uploads/plugin` (Claude/Codex plugin version, not published) |\n| `skills/` | The three agent skills that ship to users |\n| `hooks/`, `plugins/`, `.mcp.json` | Agent-runtime wiring: the shared pre-PR screenshot hook and the Claude / Codex plugin manifests |\n| `server.json` | MCP Registry listing (`sh.uploads/mcp`): stdio `uploads mcp` plus the hosted remote |\n\nEach worker and the web app deploy separately. All storage access goes through\n`createStorage()` in `packages/storage` — adding a provider is one new case\nplus peer deps, no API changes.\n\n## Docs\n\nProduct docs — install, the staged loop, the GitHub App, limits — live at\nhttps://uploads.sh/docs. The docs in this repo are the companion: CLI and API\nreference, contributor setup, and operator material, all mapped from\n[docs/README.md](https://github.com/buildinternet/uploads/blob/main/docs/README.md).\n\nHow to set up, test, and open a pull request: [CONTRIBUTING.md](https://github.com/buildinternet/uploads/blob/main/CONTRIBUTING.md).\nWhere the project is headed: [VISION.md](https://github.com/buildinternet/uploads/blob/main/VISION.md). Agent working conventions\nlive in [AGENTS.md](https://github.com/buildinternet/uploads/blob/main/AGENTS.md), and agents that land on this repo should start\nat [llms.txt](https://github.com/buildinternet/uploads/blob/main/llms.txt). The product site serves https://uploads.sh/llms.txt\nand https://uploads.sh/llms-full.txt.\n\n## Local development\n\n**Prerequisites:** Node ≥24 and pnpm ≥11 (`corepack enable`). No Cloudflare\naccount needed for the core local loop — `wrangler dev` simulates R2, KV, and\nD1 on disk:\n\n```bash\npnpm bootstrap # one-command setup: tooling, deps, env vars, local D1, default workspace\npnpm dev # API on :8787 (local R2 + KV + D1)\n```\n\n`bootstrap` is idempotent, and `pnpm doctor` diagnoses a setup without changing\nit. The rest of the loop — the authenticated dev stack, the check and test\ngates, and how to open a pull request — is in\n[CONTRIBUTING.md](https://github.com/buildinternet/uploads/blob/main/CONTRIBUTING.md).\n\n## License\n\n[Apache 2.0](https://github.com/buildinternet/uploads/blob/main/LICENSE).\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt",1790463551000,"priceCents","trialDays","iconType","image","upstream",{"_113":114,"_115":116,"_117":118,"_119":120,"_121":122,"_123":124},"requiredSecrets",[],"tags",[103,104,105,106,107,108,109,110,111,112],"assets",[],"stats",{"_101":45,"_102":45},"ratingAvg","reviewCount","agent-skills","agent-tools","agents","cli","cloudflare","cloudflare-r2","file-hosting","image-upload","s3","screenshots","topics",[103,104,105,106,107,108,109,110,21,111,112],"license","Apache-2.0","language","TypeScript","registryName","sh.uploads/mcp","homepage","https://uploads.sh","packages",[125],{"_126":127,"_128":129,"_78":79},"registryType","npm","identifier","@buildinternet/uploads","ENV",{"_132":133,"_134":135,"_136":137,"_138":-7},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272","SENTRY_ENABLE_LOCAL"]