OWL Compose CLI

OWL Compose provides the ow command and the openwiki-a2ui Skill used by AI agents to create and publish OWL Compose documents.

Using the platform

OWL Compose is a subscription product for document creation, publishing, updates, and sharing. This package installs the tools used by your AI agent. OWX sources and compiled JSON are inputs to the platform, not standalone readable documents. Publish to the platform to view and use the result; installing the CLI alone does not provide a local document app.

Requirements

• An Active LTS or Maintenance LTS release of Node.js, with npm.
• macOS on Apple silicon, 64-bit Linux with glibc, or 64-bit Windows. Intel Macs are not supported in new releases.
• Codex, Claude Code, Cursor, Grok, or OpenCode.

Install

Run:

npx --yes --package @owlcompose/cli@latest ow setup --target auto

Setup installs the ow CLI globally, installs the matching openwiki-a2ui Skill into each detected agent, checks the installation, and opens the OWL Compose sign-in page. Start a new agent session after setup so the agent loads the Skill.

Both owlcompose.com and openwiki.md use this package. Pass --remote https://openwiki.md when connecting through the code understanding site. Saved credentials remain scoped to their service. The historical openwiki-a2ui Skill identifier is retained so existing Agent installations update in place.

Update

Run the same command again:

npx --yes --package @owlcompose/cli@latest ow setup --target auto

The command updates the CLI and Skill together. Valid saved credentials are kept. Start a new agent session after updating.

Verify

Check the CLI version and Skill installation:

ow --version
ow agent doctor --target auto

Sign in and Skill targets

Setup opens the OWL Compose sign-in page when sign-in is required. To use a different account, run:

npx --yes --package @owlcompose/cli@latest ow setup --target auto --relogin

--target auto installs the Skill for detected agents. To select one explicitly, replace auto with codex, claude, cursor, grok, or opencode.

Troubleshooting

• If ow is not found after setup, open a new terminal. If it is still missing, run npm config get prefix and make sure the npm executable directory is on PATH.
• If npm reports a permissions error, install Node.js with a version manager and run setup again.
• If an agent reports a missing or stale Skill, run the setup command again and start a new agent session.
• Run ow agent doctor --target auto for a detailed installation check.

Uninstall

Remove the Skills before removing the CLI:

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

Commands

Run ow --help to list commands and ow <command> --help for command-specific options.

Common entry points:

ow a2ui      Build and inspect OWL Compose documents
ow publish   Publish a compiled document
ow pull      Download the current document revision
ow media     Import image assets
ow agent     Install, remove, and verify Agent Skills
ow setup     Configure sign-in and Agent Skills