Skip to content

Maintenance ​

Keep the CLI fresh and jump to the right URL fast.

orion upgrade ​

Upgrade the CLI to the latest version from npm. Detects whether a newer version is available and prompts for confirmation. For npm, runs npm install -g @orion-ehr/cli@latest directly; for pnpm/yarn it prints the equivalent command and exits without invoking it.

bash
orion upgrade

Flags ​

FlagPurpose
--checkOnly report whether a newer version is available; do not install. Exit code: 0 up to date, 1 newer available, 2 registry unreachable. CI-friendly.
-y, --yesSkip the confirmation prompt and install if outdated.

Background notifier ​

After any orion command, a once-per-24-hour background check runs against the npm registry. When a newer version is available, a hint prints to stderr after the command output:

📦 @orion-ehr/cli 0.0.10 available (current 0.0.9) — run `orion upgrade`

Suppressible via:

VariableEffect
ORION_NO_UPDATE_NOTIFIER=1Disable the notifier entirely.
CI=trueAuto-detected on most CI runners; suppresses the notifier.

orion open [target] ​

Open Orion destinations in your browser. Interactive picker when target is omitted.

bash
orion open portal
orion open marketplace
orion open sandbox
orion open docs
orion open                    # interactive picker
TargetResolves to
portalYour developer portal entry for the current app: <host>/developer/apps/<slug>
marketplaceMarketplace listing for the current app: <host>/marketplace/app/<slug> (or <host>/marketplace when run outside an app directory).
sandboxSandbox developer console on your home tenant: <host>/developer/sandbox
docshttps://docs.orionsoftware.io

Flags ​

FlagPurpose
--printPrint the resolved URL instead of opening the browser. Useful when piping to pbcopy or sharing in chat.

orion sandbox ​

Manage your sandbox environment. The sandbox tenant is the scratch space orion dev tunnels into — see Host vs Sandbox.

CommandPurpose
orion sandbox:statusPrint sandbox URL, health status, configured app id, and the registered dev URL when known.
orion sandbox:resetWipe the sandbox back to a fresh state.

Seeding the sandbox with test data is done from the Orion UI, not the CLI.

Documents @orion-ehr/cli v0.0.16 — released under the MIT License.