A field guide
Outpost°
outpost.offsprint.xyz
Three ways to share a document

Hand us a file. Get back a link.

Outpost is a small service for publishing .html and .md documents to a clean, shareable URL. You can use it from a browser, from your terminal, or from an AI agent — whichever fits the moment. This page walks through all three.

Accepts
.html · .md · .zip
Anonymous
2 MB · 14‑day expiry
Signed in
10 MB · no expiry
Default visibility
private

01The web portal

browser

For the one-off share · works without an account

Visit outpost.offsprint.xyz/upload and drop in a file. The portal accepts a single .html or .md document, or a .zip bundle — zips are unpacked server-side and must contain an index.html at the root.

  • Anonymous: up to 2 MB, the doc lives for 14 days, you choose public or private at upload time.
  • Signed in (Google or Microsoft): up to 10 MB, no expiry, private by default. After upload you land in the editor.

Why two domains

The app lives on outpost.offsprint.xyz (where auth and the editor live). Public docs are served from usercontent.offsprint.xyz — a separate origin so any JavaScript inside an uploaded HTML page cannot read your session cookie.


02The CLI

terminal

For the things you already produce on disk

The outpost CLI is a single Node binary that talks to the same upload endpoints. Install it once, sign in once, and uploading is a single command from anywhere on your machine.

# Install (or skip and use npx)
npm i -g @offsprint/outpost

# One-time auth — opens a browser to approve the device
outpost login

# Share a file
outpost upload ./report.html --title "Q1 report" --public

# Or pipe text in directly
echo "# hello" | outpost upload - --format md

A successful upload prints the share URL. Add --json to get {slug, url, title, type} for scripting. Tokens are stored at %APPDATA%\outpost\auth.json on Windows or ~/.config/outpost/auth.json elsewhere, and last 90 days.

Useful flags

--title "..." · --public · --format html|md (required for stdin) · --json for machine output. Default visibility is private; you have to opt in to public.


03The agent skill

claude / copilot / cursor / ...

Give your assistant the verb “share this”

An Agent Skill ships with this repo so any compatible AI agent can drive the CLI for you. After installing it, asking your agent “share this file” or “give me a public link to this report” is enough — the agent picks the right command, runs it, and hands back the URL.

# Install once with the GitHub CLI (gh 2.90+)
gh skill install sah1l/outpost outpost

# Now ask your agent something like:
→ "upload ./notes.md and give me a public link"
→ "replace the contents of outpost.offsprint.xyz/s/sprint-notes with this file"

The skill knows the boundaries: it will not invent documents to upload, will not flip a doc to public unless you asked, and remembers slugs from the current session so “update what we just shared” works without you pasting the URL again. For local files it can also write a small <!-- outpost-slug: ... --> marker so future updates from a fresh session still know which doc to replace.


04Updating a doc you’ve already shared

Same URL, new contents

Every share has a stable slug. Updating the contents keeps the URL identical — useful for living documents (release notes, status pages, weekly reports) where you do not want to re-paste a fresh link every time.

# From a file (must match the doc's existing type — html or md)
outpost update sprint-notes ./sprint-notes.md

# Inline replacement
outpost update sprint-notes --format md --text "# Updated"

# Metadata only — no body change
outpost update sprint-notes --title "Sprint 42"
outpost update sprint-notes --public        # or --no-public

Visibility is tri-state: omit both flags to leave it as-is. The doc’s format is fixed at upload time — to change html to md or vice versa, delete and re-upload.


05Which one should I use?

A short cheat sheet

If you…Reach for…
just have a file in your downloads folderthe portal
publish the same kind of doc weeklythe CLI + a script
are mid-conversation with an AI assistantthe agent skill
need the URL to stay the sameoutpost update <slug>
want a quick anonymous share, no accountthe portal, anonymous mode

All three paths hit the same backend, write to the same Firestore record, and produce the same outpost.offsprint.xyz/s/<slug> URL. Pick whichever has the lowest friction for the task in front of you.