@buildinternet/uploads

@buildinternet/uploads

CLI and client for uploads.sh — upload files, get public URLs, and produce GitHub-ready markdown. Successor to the R2 scripts in buildinternet-skills/github-screenshots.

CLI

Binary: uploads (also pnpm uploads from repo root after pnpm install).

Install globally or run a pinned version without installing:

npm install --global @buildinternet/uploads
npx @buildinternet/uploads@0.1.0 --help

pnpm uploads setup --env-file .env
pnpm uploads attach ./before.png ./after.png --env-file .env
pnpm uploads put ./shot.png --env-file .env
pnpm uploads put ./after.png --pr 123 --comment --env-file .env
pnpm uploads doctor --env-file .env

Commands: attach, put, comment, list, delete, setup, config, doctor, health.

attach is the agent-friendly default for GitHub media. It accepts one or more files, infers the pull request for the current branch via gh, uploads stable URLs, and creates or updates one managed attachments comment. Use --pr, --issue, and --repo to select the target explicitly, or --no-comment to upload without changing GitHub comments.

Config layers (first match wins): CLI flags → env vars → --env-file → ~/.config/buildinternet/config. See config.example for keys.

Programmatic use

import { createUploadsClient } from "@buildinternet/uploads";

Agent/MCP helpers: @buildinternet/uploads/agent (createUploadsWorkerFileTools for Workers).

Layout

src/
  cli.ts            Entry + help
  commands.ts       put, list, delete, comment, …
  client.ts         HTTP client for the API
  github.ts         PR/issue key paths + attachment comments
  embed.ts          Markdown image output
bin/uploads.js      Bin shim

Commands

pnpm build        # tsc → dist/
pnpm typecheck
pnpm test
pnpm pack:check   # verify the npm tarball contents

Maintainer release instructions: docs/releasing.md.

Agent-oriented usage: skills/uploads-cli/SKILL.md. REST details: docs/api.md.