uploads

v0.2.3

Host screenshots, GIFs, recordings, and files on uploads.sh and embed them in GitHub PRs and issues.

CodexAgent Plugins2 Skills1 MCP serverStreamable HTTP

By Build InternetLicense: Apache-2.019 GitHub starsUpdated 1 hour ago

Directory evidence

Runtimes: Codex and Agent Plugins
Parsed components: 3 skill or MCP entries
Source updated: Sep 26, 2026
Manifest status: Canonical path parsed

The directory validates manifest shape and source location. It does not execute the plugin or provide a security endorsement. Review the indexing methodology →

Install uploads for Codex

Installs for the current user

codex plugin marketplace add IchenDEV/agent-plugin-mkt
codex plugin marketplace upgrade agent-plugin-marketplace
codex plugin add uploads@agent-plugin-marketplace

Paste and run these commands in a terminal with Codex. They add and refresh the PluginsMP catalog, then install this plugin.

The installer fetches third-party code from the source repository shown on this page. This directory validates manifest structure and source location, but does not perform a security audit; review the manifest, components, and source before installing.

Get the source manually

$ git clone https://github.com/buildinternet/uploads

Clone the source repository, then follow its setup instructions to add the plugin to a compatible client. The repository root is the plugin root.

Plugin files

uploads/

├── .codex-plugin/plugin.json
├── plugin.json
├── skills/annotate-screenshots/SKILL.md
├── skills/uploads-cli/SKILL.md
└── .mcp.json

Included Skills2

annotate-screenshotsskills/annotate-screenshots/SKILL.md

Bake hand-drawn boxes, arrows, labels, freeform strokes, and redactions onto a screenshot so a PR reviewer or teammate sees exactly what changed and where to look, instead of reading a caption and hunting for it. Use this whenever a screenshot needs a callout — "point at the new button", "circle the bug", "arrow to the diff", "blur out the API key in this screenshot", "mark up this image before I attach it". Covers both annotating a live page during capture (`uploads screenshot --annotate`, CSS selector targeting) and annotating an image you already have (`uploads annotate`, pixel/freeform coordinates only). For getting the resulting image into a GitHub PR or issue, hand off to the github-screenshots skill — this skill only covers producing the annotated image.

uploads-cliskills/uploads-cli/SKILL.md

Reference for the uploads CLI and its stdio/hosted MCP tools — exact flags, keys, and contracts for put and attach, screenshot capture, stable PR/issue keys, the managed attachments comment, metadata and search, galleries, change feeds (repo-wide or one PR/issue), config defaults, login/doctor, and output formats. Use when driving the `uploads` CLI or its MCP tools (including the hosted MCP at agents.uploads.sh for agents without local filesystem/git access), when you need a public URL for a local file ("upload this", "host this image", "give me a public URL for this file"), when the CLI itself prints a hint or nudge you need to act on (a `hint` field in `--format json`, or the stderr note suggesting `--pr`/`attach --branch`), or when you need exact flags, key layouts, or setup and auth details. For the when-and-how of getting a screenshot or recording into a GitHub PR or issue, start with the github-screenshots skill — it defers here for CLI detail.

MCP servers1

uploadsStreamable HTTP

url: https://agents.uploads.sh/mcp

Plugin manifests2

.codex-plugin/plugin.json

{
  "name": "uploads",
  "version": "0.2.3",
  "description": "Host screenshots, GIFs, recordings, and files on uploads.sh and embed them in GitHub PRs and issues.",
  "author": {
    "name": "Build Internet",
    "url": "https://buildinternet.com"
  },
  "homepage": "https://uploads.sh",
  "repository": "https://github.com/buildinternet/uploads",
  "license": "Apache-2.0",
  "keywords": [
    "uploads",
    "screenshots",
    "github",
    "file-hosting",
    "images",
    "mcp"
  ],
  "skills": "./skills/",
  "mcpServers": "./.mcp.json",
  "hooks": "./hooks/hooks.json",
  "interface": {
    "displayName": "uploads.sh",
    "shortDescription": "Host files for GitHub PRs",
    "longDescription": "Host screenshots, GIFs, recordings, and files on uploads.sh and embed them in GitHub PRs and issues. Bundles the github-screenshots, annotate-screenshots, and uploads-cli skills, the hosted MCP server at agents.uploads.sh, and a pre-PR screenshot reminder hook.",
    "developerName": "Build Internet",
    "category": "Developer Tools",
    "capabilities": [
      "Host files on a public CDN",
      "Attach media to GitHub PRs"
    ],
    "websiteURL": "https://uploads.sh",
    "supportURL": "https://github.com/buildinternet/uploads/issues",
    "privacyPolicyURL": "https://uploads.sh/privacy",
    "termsOfServiceURL": "https://uploads.sh/terms",
    "defaultPrompt": [
      "Attach this screenshot to the current pull request",
      "Stage a before/after of the settings page for this branch",
      "Give me a public URL for this image"
    ],
    "brandColor": "#c27eff",
    "composerIcon": "./assets/logo.png",
    "logo": "./assets/logo.png"
  }
}

plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "uploads",
  "version": "0.2.3",
  "description": "Host screenshots, GIFs, recordings, and files on uploads.sh and embed them in GitHub PRs and issues.",
  "author": {
    "name": "Build Internet",
    "url": "https://buildinternet.com"
  },
  "homepage": "https://uploads.sh",
  "repository": "https://github.com/buildinternet/uploads",
  "license": "Apache-2.0",
  "keywords": [
    "uploads",
    "screenshots",
    "github",
    "file-hosting",
    "images",
    "mcp"
  ],
  "extensions": {
    "com.anthropic.claude-code": {
      "pluginManifest": "plugins/claude/uploads/.claude-plugin/plugin.json",
      "marketplace": ".claude-plugin/marketplace.json",
      "mcp": "plugins/claude/uploads/.mcp.json",
      "hooks": "plugins/claude/uploads/hooks/hooks.json"
    },
    "com.openai.codex": {
      "pluginManifest": ".codex-plugin/plugin.json"
    }
  }
}