npm.io
0.4.0 • Published 3d agoCLI

sharer-app

Licence
MIT
Version
0.4.0
Deps
0
Size
17 kB
Vulns
0
Weekly
0

sharer-app

Share HTML/Markdown files as instant links — built for AI coding agents like Claude Code and Codex.

# Login once (browser approval)
npx sharer-app login

# Push a file, get a shareable URL on stdout
npx sharer-app push out.html
# => https://xxxxxxxxxx.sharer-app.com/

# Markdown works too (rendered with GitHub-like styling)
npx sharer-app push README.md

# Push a whole directory — CSS/JS/images keep their relative paths
# (hidden files, symlinks and unsupported extensions are skipped)
npx sharer-app push ./site/

# Options
npx sharer-app push report.html --password mypass --expires 3d --title "Weekly report"
npx sharer-app push out.html --json
# => {"id":"...","url":"https://...","expiresAt":1781653885,"password":false}

npx sharer-app list
npx sharer-app password <shareId> <pw>     # set/change password on an existing share
npx sharer-app password <shareId> --remove # remove password protection
npx sharer-app revoke <shareId>
npx sharer-app delete <shareId>

Designed for AI agents

  • stdout carries only the URL (or JSON with --json) — progress and errors go to stderr, so URL=$(npx sharer-app push out.html) just works
  • Non-interactive: no prompts when not a TTY; exits 1 with instructions on stderr
  • SHARER_APP_TOKEN env var for CI / agent environments
  • npx sharer-app install-skill appends usage instructions to your project's CLAUDE.md

Features

  • Instant link from any HTML/Markdown file (multi-file shares supported)
  • Optional password protection
  • Expiring links (30m / 8h / 3d / 7d / never, default 7d) — storage is physically deleted after expiry
  • Team dashboard at app.sharer-app.com
  • Shared content is served on isolated per-share subdomains, never on the app origin

Keywords