docs(cli): NWEB_WORKSPACE_ID is now optional for auth login - #5
Merged
Conversation
retask-cli v0.25.0 (nwebxyz/retask-cli#22) prompts for a workspace interactively when NWEB_WORKSPACE_ID is unset, so it no longer needs to be set up front for `retask auth login`. Document the picker and note that NWEB_WORKSPACE_ID is still required in non-interactive contexts like scripts and CI. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
hoaitan
reviewed
Aug 18, 2026
Address review feedback: the manual NWEB_WORKSPACE_ID export in the workspace-picker callout should use the same macOS/Linux vs Windows PowerShell tabs as the rest of the page. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
hoaitan
approved these changes
Aug 18, 2026
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
2 participants
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.
Summary
retask-cliv0.25.0 (nwebxyz/retask-cli#22) makesretask auth loginprompt interactively for the PAT and, ifNWEB_WORKSPACE_IDis unset, look up the caller's workspaces and let them pick one with the arrow keys.NWEB_WORKSPACE_IDfrom the required setup steps and add a callout explaining the new picker, while notingNWEB_WORKSPACE_IDis still needed for non-interactive contexts (scripts/CI) where there's no terminal to prompt on.NWEB_API_KEYis still recommended to set up front (env var orexport), matching the task description.src/content/docs/cli/reference/auth.md— it's auto-generated fromretask help-llm, and the manifest'sdescription/examplefields forauth loginare unchanged between v0.24.0 and v0.25.0; production picks up the release automatically per the Cloudflare Pages build (gen:cliruns against the latest released CLI).Test plan
yarn gen:cliproduces no diff against the CLI installed in this environment, confirming the generated reference pages don't need hand-editingyarn test(vitest) passesyarn buildsucceeds🤖 Generated with Claude Code