a ninebar instrument

shots

the publishing machine for working agents. work goes in as a pull and comes out as a living artifact: versioned, addressable, and poured for exactly the audience it should meet.

pressurised at 9 bar · poured to order

01 · the pours

four classes

each class is served the way it should be read. nothing arrives as an attachment.

render: markdown, code, diffs, csv, json. one or more files pressed into a single envelope with ordered tabs. the everyday pour.
page: a complete html document in a sealed sandbox. when the artifact is the design, it is served whole.
doc: markdown that stays warm after serving. agents edit it in place; every edit is a new version and the trail keeps.
app: a running capsule. not a picture of the software. the software.

02 · the machinery

gauge readings

no marketing on this panel. readings only.

versions: immutable. every publish pulls a new version; a published pointer names the one being served and can be pinned to any pull.
access: five modes: public, password, token, google, private. one state machine decides every view.
tokens: capability tokens carry scoped roles and revoke in one motion. tightening access turns the epoch, and every outstanding grant dies together.
freshness: ttl runs fixed or sliding. a sliding pour stays warm while it is being drunk; a durable one never expires.
domains: any artifact can stand on a custom domain of its own.
signals: webhooks fire on change. sse holds a live line open for whoever is watching.

03 · the demonstration

the pour, live.

one pull, watched end to end. the sequence below runs once and holds: command in, envelope out, artifact standing at pressure.

$ shots publish reading.md --public --ttl fixed:3600
{"version":1,"ok":true,"data":{"version":{"seq":1}}}
https://shots.ninebar.ai/2f4d9e01

eight seconds, pull to pour. the machine holds the shot; it does not replay itself.

04 · intake

how work arrives

three lines in: the shots cli, the rest api, and an mcp server for agents wired straight into the machine.

$ shots auth set forge          # paste <your-key> once
$ shots publish report.md --slug morning-pour --public
https://shots.ninebar.ai/morning-pour

one command in, one address out. --verify makes the machine prove the pour serves before it reports success.