1. Confirm the installation
Run both checks on the machine where the Agent will author the work. Doctor must report the intended Agent target as ready.
ow --version
ow agent doctor --target auto2. Create the editable OWX source
Ask the Agent to create a package-local document.owx. This minimal source is complete enough to validate and compile; real work should choose its structure from the reader task and retained evidence.
<ow-document owx-version="1" title="Decision brief" language="en" canvas="briefing">
<section id="overview">
<h2>Decision</h2>
<ow-text id="summary" title="Decision brief" title-level="1" body="State the decision, evidence, and next action." />
</section>
</ow-document>3. Validate and compile
Fix the OWX source when a command fails. Never patch the generated JSON to bypass validation.
ow a2ui check ./artifact/document.owx
ow a2ui fmt ./artifact/document.owx
ow a2ui compile ./artifact/document.owx --output ./artifact/document.json
ow a2ui digest ./artifact/document.json4. Publish, inspect, and share deliberately
Sign in, publish the compiled JSON, and open the returned owner page. Ordinary works are private by default. When a reader needs access, choose Get share link, select 24h, 7d, or 30d, and create the view link. Revoke it from the Sharing tab when access should stop.
ow login
ow publish ./artifact/document.jsonPublishing does not upload the Agent conversation or unrelated local files. Only the compiled artifact and its package-bound assets are sent.
Preguntas
Preguntas frecuentes
Do I need a subscription to compile locally?
No. OWX authoring, validation, formatting, compilation, and digest run locally. Hosted publishing and creation of CLI/API credentials require an active subscription.
Does publish create a public reader link?
No. The work is private by default. The author creates a separate time-limited view link from the owner page when sharing is intentional.
Usa el flujo real
Publica lo que crea tu agente.
Instala la CLI, crea en OWX, valida localmente y publica una obra privada. Crea un enlace para lectores solo cuando vayas a compartirla.