mirror of
https://github.com/stablyai/orca.git
synced 2026-11-18 03:45:08 +00:00
- shot <key|dir> --scenario <name> renders the panel in that check scenario through the check runner (a separate Node process on a mock host and mounted worker), sends the validated drawn tree to a new plugins.shotReplay, and captures it in a throwaway preview surface: no guest, no live host, no real storage or settings, no real worker, images as placeholders. Window hidden or minimized only; --act, --environment and bridged shells refused; an older host answers method_not_found (runtime_unsupported) rather than doing a live shot. - dev watch's shot event carries pendingRequests.
3.3 KiB
3.3 KiB
Plugin CLI commands
ORCA is the Orca executable you resolved. Every command takes --json; branch on error.code. Exit codes: 0 ok, 1 error, 2 the plugin is invalid (plugin_invalid), 3 approval is needed (approval_required or approval_stale). Run ORCA <command> --help for a command's notes.
ORCA plugin create <dir> --template <theme|terminal-theme|icon-theme|syntax|language-pack|editor|panel|components|worker-panel> [--publisher <name>] [--id <id>] [--name <display name>] [--json]: Scaffold a new Orca plugin from a templateORCA plugin types <dir> [--json]: Write the TypeScript typings for Orca plugins into a plugin folderORCA plugin test [dir] [--json]: Run a plugin's own tests on this machine, unsandboxed: only for code you trustORCA plugin check [dir] [--json]: Validate a plugin and render each components panel once on this machine, unsandboxed: only for code you trustORCA plugin validate <dir|orca-plugin.json|orca-catalog.json> [--json]: Check a plugin folder, manifest or catalog the way Orca will load itORCA plugin inspect <dir> [--json]: Show what a plugin folder contributes, the access it asks for, and its content hashORCA plugin release-entry <dir> [--json]: Print the catalog release entry for a plugin folder's committed HEADORCA plugin list [--json]: List plugins on the Orca host with their status and access levelORCA plugin logs <plugin-key> [--json]: Print the recent log lines of a pluginORCA plugin enable <plugin-key> [--approve <fingerprint>] [--json]: Enable a plugin; code and capabilities need --approveORCA plugin disable <plugin-key> [--json]: Disable a pluginORCA plugin system on [--json]: Turn plugins on for the Orca hostORCA plugin system off [--json]: Turn plugins off for the Orca hostORCA plugin restart <plugin-key> [--json]: Stop a plugin's worker so its next command or event starts it freshORCA plugin dev watch <dir> [--check] [--shot <out-dir> [--shot-panel <id>]] [--approve <fingerprint>] [--json]: Load a plugin folder, then stream its logs and reloads until Ctrl-CORCA plugin dev load <dir> [--approve <fingerprint>] [--json]: Load a plugin folder into Orca as a development pluginORCA plugin dev reload [<dir>] [--approve <fingerprint>] [--json]: Reload development plugins now, or one folder and re-check its approvalORCA plugin dev inspect <plugin-key> [--json]: Open DevTools for a plugin's open panels and editorsORCA plugin dev emit <dir|plugin-key> <event> [--data <json>] [--json]: Fire a test event at a development plugin's worker and open panelsORCA plugin dev request <dir|plugin-key> <name> [--data <json>] [--panel <id>] [--timeout-ms <ms>] [--json]: Call a development plugin's worker handler the way a panel's plugin.request doesORCA plugin dev unload <dir|plugin-key> [--json]: Remove a development folder from OrcaORCA plugin open <plugin-key> [--panel <id> | --editor <file>] [--json]: Show a plugin's panel in Orca's right sidebar, or open a file in its editorORCA plugin shot <plugin-key|dir> [--panel <id>] [--theme <light|dark>] [--width <px>] [--act '<json>' | --scenario <name>] [--out <file.png>] [--json]: Save a PNG of a plugin panel exactly as Orca draws it, to look at what you built