tinyhumansai/openhuman · error

[deep-link] openhuman:// scheme registration unhealthy — OAu

Error message

[deep-link] openhuman:// scheme registration unhealthy — OAuth callbacks may never reach the app. register_all_error={register_err:?}, hkcu_status={status_log}. See gitbooks/overview/troubleshooting-sign-in.md ("Windows: openhuman:// handler not registered") for the manual repair.

What it means

Error "[deep-link] openhuman:// scheme registration unhealthy — OAuth callbacks may never reach the app. register_all_error={register_err:?}, hkcu_status={status_log}. See gitbooks/overview/troubleshooting-sign-in.md ("Windows: openhuman:// handler not registered") for the manual repair." thrown in tinyhumansai/openhuman.

Source

Thrown at app/src-tauri/src/lib.rs:2910

                // it only logs at `warn` — when its single internal write
                // fails outright; it does not verify what's on disk. Issue
                // #2699 reports OAuth callbacks silently disappearing on
                // some Windows installs, which traced back to a missing or
                // stale `command` value here. Read it back and log loudly
                // (Sentry-level `error`) so the failure mode is observable
                // in support logs; we deliberately do NOT auto-repair —
                // writing the wrong exe path can brick a working install.
                let register_err = app.deep_link().register_all().err();
                let status = deep_link_registration_check::verify_protocol_registration();
                let status_log = status.redacted();
                if register_err.is_none() && status.is_healthy() {
                    log::info!("[deep-link] openhuman:// scheme registered ({status_log})");
                } else {
                    // Use the redacted form so per-user install paths
                    // (`C:\Users\<username>\...`) do not land in Sentry / user
                    // logs — basenames are kept so the diagnostic still
                    // identifies the registered exe.
                    log::error!(
                        "[deep-link] openhuman:// scheme registration unhealthy — \
                         OAuth callbacks may never reach the app. \
                         register_all_error={register_err:?}, hkcu_status={status_log}. \
                         See gitbooks/overview/troubleshooting-sign-in.md \
                         (\"Windows: openhuman:// handler not registered\") for the manual repair."
                    );
                }
                deep_link_ipc_windows::drain_pending_urls(app.app_handle());
            }
            #[cfg(target_os = "linux")]
            {
                // `tauri-plugin-deep-link::register_all` on Linux shells out
                // to `xdg-mime`, `update-desktop-database`, and
                // `xdg-icon-resource` in sequence to install MIME-type
                // associations for our custom URL schemes. On Linux installs
                // that ship without one or more of those binaries — WSL2
                // without a desktop env, headless servers, minimal
                // containers (OPENHUMAN-TAURI-AS: WSL2 user in BR;

View on GitHub (pinned to 7491200858)

Solutions

1. Follow the referenced manual repair in gitbooks/overview/troubleshooting-sign-in.md ('Windows: openhuman:// handler not registered')
2. Manually set HKCU\Software\Classes\openhuman\shell\open\command to the installed openhuman.exe path (quote the path, append the invocation args matching the existing value shape)
3. Re-run sign-in and confirm the browser redirect reaches the app
4. Do not attempt an in-app auto-repair — writing a wrong exe path can brick a working install, which is why the code only reports

When it happens

Trigger: Thrown at app/src-tauri/src/lib.rs:2910 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of tinyhumansai/openhuman@7491200858 (2026-08-17). Data as JSON: /api/errors/8ff8853701279868. Report an issue: GitHub.