OWL Compose

Install OWL Compose

Let your Agent install OWL Compose.

Copy this message to an Agent that can run commands. It handles installation and checks; you connect your account through a link.

macOS · Linux · Windows

Read https://owlcompose.com/install.md and follow its instructions to install and configure OWL Compose for this Agent. Check the environment, install the CLI and matching Skill, connect my OWL Compose account, and verify installation and login. When I need to register, sign in, or authorize access, give me the link and verification code. Continue checking after I finish. Never display access credentials in the conversation.

  1. Send the message to your Agent
  2. Open the link to connect your account
  3. Let your Agent finish verification
Manual installation, updates and troubleshooting
01

Install

npx downloads the latest official package, persists that exact release as the ow command, and starts account and skill setup. Use this same command for every update.

Terminal
npx --yes @owlcompose/cli@latest setup --target auto --device --remote https://owlcompose.com
02

Update

Run the installation command again. The CLI and embedded Agent skill move to the same latest release.

npx --yes @owlcompose/cli@latest setup --target auto --device --remote https://owlcompose.com
03

Verify the installation

Run doctor to check the CLI and skill files. Then restart your Agent or open a fresh session to load the installed skill; doctor does not check the current session.

Terminal
ow --version
ow agent doctor --target auto
ow status --remote https://owlcompose.com

05 · Quickstart

Next: publish your first document

Create the minimal OWX source below, run the complete local gate, then publish only the generated Render Document JSON.

Expected result: document.json and its digest are created locally; publish returns the owner page; the Hosted work remains private until you explicitly create a time-limited view link.

my-work/document.owx
<ow-document canvas="briefing" language="en" owx-version="1" title="Decision brief">
  <section id="overview">
    <h2>Decision</h2>
    <ow-text body="State the decision, evidence, and next action." id="summary" title="Decision brief" title-level="1" />
  </section>
</ow-document>
Terminal
ow a2ui check ./my-work/document.owx
ow a2ui fmt ./my-work/document.owx
ow a2ui compile ./my-work/document.owx --output ./my-work/document.json
ow a2ui digest ./my-work/document.json
ow login
ow publish ./my-work/document.json
Open the quickstartRead the CLI reference

CLI maintenance

Troubleshoot or remove OWL Compose

Sign in again (optional)

Installation already handles sign-in and reuses saved credentials when accepted. Run this only when you need to sign in again. Credentials stay outside the project.

ow setup --device --relogin --target auto --remote https://owlcompose.com

Troubleshoot

Check Node.js, npm, and doctor first. If ow is missing after installation, check npm's global bin directory and your PATH; do not use sudo to repair npm permissions.

node --version
npm --version
ow agent doctor --target auto

Uninstall

Remove the managed skills first, then uninstall the global npm package. Documents and account credentials are not deleted.

ow agent uninstall --target all
npm uninstall --global @owlcompose/cli