Maintenance

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

• orion upgrade
  • Flags
  • Background notifier
• orion open [target]
  • Flags
• orion sandbox

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.

orion upgrade

Flags

Flag	Purpose
--check	Only 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, --yes	Skip 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:

Variable	Effect
ORION_NO_UPDATE_NOTIFIER=1	Disable the notifier entirely.
CI=true	Auto-detected on most CI runners; suppresses the notifier.

---

orion open [target]

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

orion open portal
orion open marketplace
orion open sandbox
orion open docs
orion open                    # interactive picker

Target	Resolves to
portal	Your developer portal entry for the current app: <host>/developer/apps/<slug>
marketplace	Marketplace listing for the current app: <host>/marketplace/app/<slug> (or <host>/marketplace when run outside an app directory).
sandbox	Sandbox developer console on your home tenant: <host>/developer/sandbox
docs	https://docs.orionsoftware.io

Flags

Flag	Purpose
--print	Print 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.

Command	Purpose
orion sandbox:status	Print sandbox URL, health status, configured app id, and the registered dev URL when known.
orion sandbox:reset	Wipe the sandbox back to a fresh state.

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