docs(cli): document device-code login for headless environments#1429
Open
SahilAujla wants to merge 3 commits into
Open
docs(cli): document device-code login for headless environments#1429SahilAujla wants to merge 3 commits into
SahilAujla wants to merge 3 commits into
Conversation
@alchemy/cli 0.18.0 added an OAuth 2.0 Device Authorization Grant (RFC 8628) so alchemy auth works in Codespaces, sandboxes, SSH, and CI where the browser cannot reach the CLI's localhost callback. Add a Headless and remote environments subsection to the Authenticate section and a command-reference row for alchemy auth login --device-code. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
🔗 Preview Mode
|
![chatgpt-codex-connector[bot]](https://avatars.githubusercontent.com/in/1144995?s=60&v=4){kind=small}
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 6e956f2967
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Enumerate exactly which environments switch to the device flow on their own (Codespaces, Gitpod, Replit, Cloud Shell, Coder, SSH, and non-interactive sessions) and make explicit that the flag works everywhere, with the browser-login timeout pointing at it as the fallback. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Collaborator
Author
|
Note for merge timing: the latest revision documents behavior that ships with OMGWINNING/alchemy-cli#103 (Replit, Cloud Shell, and Coder auto-detection plus the timeout hint). That PR auto-publishes on merge, so land it before this page goes live. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
@alchemy/cli0.18.0 added an OAuth 2.0 Device Authorization Grant (RFC 8628) login flow soalchemy authworks in headless and remote environments (GitHub Codespaces, sandboxes, SSH, CI) where the browser cannot reach the CLI's localhost callback.This documents it on the Alchemy CLI page:
alchemy auth login --device-codecommand and a note that plainalchemy authauto-detects remote/non-interactive sessionsContext
CLI side: OMGWINNING/alchemy-cli#99 (released as 0.18.0). Server side: OMGWINNING/authchemy#546-#548, live in prod.
🤖 Generated with Claude Code