omni-canvas

Stable command shim for external agents that need to operate an Omni Canvas desktop app.

npm install -g omni-canvas
omni-canvas read --project /path/to/project
omni-canvas actions --project /path/to/project --input actions.json

The shim does not implement canvas behavior. It locates the real desktop-provided CLI and forwards all arguments, stdin, stdout, stderr, and exit code.

Lookup order:

1. OMNI_CANVAS_CLI=/absolute/path/to/canvas-cli.mjs
2. ~/.omni-canvas/canvas.cli.json

The desktop app writes the config on startup:

{
  "version": 1,
  "target": "/absolute/path/to/canvas-cli.mjs",
  "registeredBy": "imaoda",
  "appVersion": "0.1.0",
  "updatedAt": "2026-07-09T00:00:00.000Z"
}

If no target is registered, omni-canvas writes a JSON error to stderr and exits with code 1.