Sharing Artifacts

Artifacts start private. Sharing is a deliberate step, and you choose whether viewers follow your edits.

1belt artifact share acme/q3-funnel

Visibility

An artifact is a capture of one person's work until it is explicitly shared, so it is created private. From there it can be shared with named people or teams, or made public — a public artifact is readable by anyone with the link, signed in or not.

Versions

Every publish appends a version. By default viewers see the latest one, so updating the page updates it for everyone who has it open.

1belt artifact versions acme/q3-funnel

You can pin instead. Pinning a version means viewers keep seeing that one while you keep publishing — useful when a link has gone out and you want to keep working without changing what people already opened.

Comments

People can leave comment threads on a published artifact.

1belt artifact comments acme/q3-funnel2belt artifact comments resolve acme/q3-funnel <thread-id>

A thread can be sent to an agent, which can then reply into it and resolve it once it has acted.

Reading one back

1belt artifact get acme/q3-funnel            # the source you published2belt artifact get acme/q3-funnel --render   # the wrapped document3belt artifact open acme/q3-funnel           # in a browser

Indexing

Published pages carry noindex, nofollow. Anyone can publish a page here; none of them should turn up in a search index on our behalf.