Oruoma Docs

Oruoma Bridge updates

Working example: core_workspace_features.py includes reserved URL tunnel and bridge sync SDK call builders.

Oruoma Bridge connects local coding tools and desktop setup flows to Oruoma inference and workspace tunnel features. Keep it updated when a new bridge release is published, especially when reserved URL tunnels, editor setup, or desktop updater behavior changes.

Check the installed version

Run:

bash
oruoma-bridge update check

The command reports:

  • the installed bridge package version
  • the latest GitHub release tag
  • whether an update is available
  • the release URL

For the latest bridge release, the expected package version is 0.1.2.post86.

Install the latest release

Run:

bash
oruoma-bridge update install

The updater normally runs through a detached helper so the current bridge process can exit before files are replaced. This is safer for platforms that lock running executables.

If you want to force reinstall from the repository even when the version already looks current:

bash
oruoma-bridge update install --yes

For diagnostics only, run the install in the foreground:

bash
oruoma-bridge update install --yes --foreground

Confirm the update

After installation:

bash
oruoma-bridge update check
oruoma-bridge --help

The update check should show the installed package and latest package version matching.

What changed in 0.1.2.post86

This release packages the bridge after reserved URL tunnel support and CI/build hardening.

Highlights:

  • workspace reserved URL tunnel support
  • reservation claim-before-start behavior
  • reservation status, logs, and stop flows
  • non-leaky authorization behavior for reservation listing and direct start attempts
  • packaged Python wheel/source archive
  • packaged VS Code-compatible editor extension artifact

Reserved URL tunnel reminder

Reserved URL tunnels are intended for authorized workspace operators. The operator key should usually have read/use scopes for reservations, while reservation management should stay with an admin key.

Typical flow:

bash
oruoma-bridge list tunnel-reservations --refresh
oruoma-bridge tunnel --reservation tres_abc123 --local-url http://127.0.0.1:5173 --name dev-dashboard
oruoma-bridge tunnel --name dev-dashboard --status
oruoma-bridge tunnel --name dev-dashboard --logs --lines 200
oruoma-bridge tunnel --name dev-dashboard --stop

Use --allow-public-local-url only when you intentionally proxy a non-private local target. The default should be local or private targets.

Update troubleshooting

SymptomLikely causeFix
Update check cannot read releasesGitHub authentication is missing for a private release sourceRun gh auth login or set the supported GitHub token environment variable for the update environment.
Update install starts but the old command remains activeThe current process still holds files openLet the detached helper finish, then open a new terminal and rerun oruoma-bridge update check.
Desktop update button failsThe desktop wrapper cannot reach the Python bridge commandRun the CLI update command directly, then reopen the desktop app.
Reserved URL is not listedThe account is not authorized for that reservationAsk an owner/admin to add the account to the reservation allow-list or use a correctly scoped operator key.