Skip to content
OpenWaggle

Browser sign-in

Connect a provider through OAuth, finish a browser login, or disconnect an account.

OAuth is browser-based sign-in. You approve access on the provider’s website without giving OpenWaggle your account password. Use it when your provider appears under OAuth Providers in Settings.

Connecting

  1. Open Settings > Connections and expand OAuth Providers.
  2. Turn on the switch beside your provider.
  3. Choose a sign-in method if OpenWaggle asks, then complete the provider’s browser flow.
  4. If OpenWaggle displays a device code, enter that code on the indicated provider page.
  5. Wait for the provider row to show Connected.
  6. Enable a model under Available Models, then select it beside the message box.

If the browser login does not finish automatically and OpenWaggle shows Paste OAuth code or callback URL, paste the code or callback URL returned by the provider and click Connect. Treat that value as a secret, not something to include in a bug report or chat message.

Some sign-ins ask in the provider’s own words, such as Paste the authorization code, and secrets you type are hidden. When the flow has a sign-in link, Copy sign-in link copies it so you can open it in a browser on another computer, then paste back the code that browser shows.

Sign-in methods

The providers and methods come from Pi, so new ones appear without an OpenWaggle update. With the Pi version bundled now:

  • OpenAI offers Sign in with ChatGPT, which uses a ChatGPT subscription with the OpenAI provider. The older OpenAI Codex provider is labelled legacy.
  • Anthropic offers browser sign-in and a copy-code method for when the browser runs on another machine.
  • Radius has its own sign-in.

Pi renamed the Azure provider from azure-openai-responses to azure. Each time OpenWaggle starts, it moves your saved Azure model choices and the model of each OpenWaggle session to the new name, and copies your Azure credential to it, keeping the old credential entry for older Pi versions. Pi’s own session files still name the old provider in their history; OpenWaggle doesn’t rewrite them. Model settings you added to Pi’s models.json under the old name have to be renamed by hand.

The provider switch stays usable during login. Turn it off to cancel an unfinished attempt. If an error appears, follow its instructions and use Try again.

Disconnecting

Turn off the provider switch. OpenWaggle logs out of that provider and refreshes its model availability.

Disconnecting removes the provider’s stored credential from Pi’s credential storage, shared with other Pi clients using the same agent directory. It does not cancel a provider subscription or remove environment-based credentials. Use the provider’s account settings to manage billing or revoke account access there.

Availability

Connected means sign-in succeeded, not that the account can use every listed model. Your provider controls subscription eligibility, model access, rate limits, and charges.

OpenWaggle gets supported OAuth providers from Pi, the agent engine included with the app. Its sign-in service uses Pi’s default runtime. A provider registered only by a project extension can appear in the model catalog without its OAuth flow being available in Connections. See Pi providers > Subscriptions for the current provider set and provider-specific requirements. Pi’s /login instructions describe its terminal interface; in OpenWaggle, use Settings > Connections instead.