Skip to content

Conversation

@xingyaoww
Copy link
Contributor

Summary

This PR adds documentation for the new LLM.subscription_login() feature that allows users to authenticate with their ChatGPT Plus/Pro subscription to access Codex models without consuming API credits.

Related SDK PR: OpenHands/software-agent-sdk#1682

Changes

  • Added new guide: sdk/guides/llm-subscriptions.mdx
  • Updated docs.json to include the new page in the "LLM Features" navigation group

Documentation Covers

  • OAuth PKCE authentication flow - Secure browser-based login
  • Credential caching - Automatic storage in ~/.local/share/openhands/auth/
  • Automatic token refresh - Seamless credential management
  • Supported models:
    • gpt-5.2-codex (default)
    • gpt-5.2
    • gpt-5.1-codex-max
    • gpt-5.1-codex-mini
  • Configuration options:
    • force_login - Force fresh OAuth login
    • open_browser - Control browser auto-open behavior
  • Requirements - ChatGPT Plus/Pro subscription, browser access

Note

OpenAI subscription is the first provider supported. The documentation is structured to accommodate future subscription providers as they are added.

@xingyaoww can click here to continue refining the PR

…hentication

This adds documentation for the new subscription_login() feature that allows
users to authenticate with their ChatGPT Plus/Pro subscription to access
Codex models without consuming API credits.

Key features documented:
- OAuth PKCE authentication flow
- Credential caching and automatic token refresh
- Supported models (gpt-5.2-codex, gpt-5.2, gpt-5.1-codex-max, gpt-5.1-codex-mini)
- Configuration options (force_login, open_browser)
- Credential storage location

Related SDK PR: OpenHands/software-agent-sdk#1682

Co-authored-by: openhands <openhands@all-hands.dev>
@openhands-ai
Copy link

openhands-ai bot commented Jan 20, 2026

Looks like there are a few issues preventing this PR from being merged!

  • GitHub Actions are failing:
    • .github/workflows/sync-agent-sdk-openapi.yml
    • .github/workflows/sync-docs-code-blocks.yml

If you'd like me to help, just leave a comment, like

@OpenHands please fix the failing actions on PR #267 at branch `feat/openai-subscription-auth`

Feel free to include any additional details that might help me get this PR into a better state.

You can manage your notification settings

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants