Repository navigation
Conversation
kcmartin
approved these changes
Oct 14, 2026
kcmartin
left a comment
Collaborator
There was a problem hiding this comment.
Reproduced the error with an empty config: sprite org auth prints "no Fly.io token found. Please run 'sprite login' first". sprite login -o matches the CLI help, and Vale is clean on the changed lines.
Optional, since you're already reworking this page: under "Select an Organization", "To switch organizations: sprite org auth --org my-team" actually adds a token for another org rather than switching. "To add another organization:" would be more accurate.
This branch has not been deployed
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
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.
The quickstart and the CLI authentication page tell new users to run
sprite org auth. On a machine that has never runsprite login, it fails:This happens even when
flyctlis logged in, becausesprite org authdoesn't read the flyctl session. The fallback the docs suggest (fly auth logout,fly auth login, then retry) doesn't fix it either.This PR switches first-time setup and re-authentication to
sprite login:quickstart.mdx: the Authenticate step usessprite login. The flyctl fallback note is gone.cli/authentication.mdx: Quick Setup, Authentication Flow and Troubleshooting usesprite login. The claim that the CLI reuses the flyctl session is gone, and "Adding Organizations" now says to log in first.working-with-sprites.mdx: the connection-error tip usessprite login.Aligns with the agent skill
The Sprites agent skill at https://fly.io/agent-skills/sprites-quickstart/SKILL.md already uses
sprite login, and so do the agent-readable pages at fly.io/sprites. With this change, the docs give people the same instructions that agents already get.The CLI agrees too.
sprite org --helpsays: "After logging in withsprite login, useorgto manage your organization tokens and defaults."Unchanged
sprite org auth --org my-teamin the multiple-organization sections. That's a correct use: it adds a token for another org aftersprite login.cli/commands.mdx, which is generated from the CLI help.Testing
I ran the quickstart with coding agents against a Fly.io account that had never used Sprites:
sprite loginsprite org authsprite login: about 90 s, 22 tool calls, 2 browser approvals plus a pasted codesprite loginsprite org authsprite login: 11 tool callsEvery
sprite org authrun ended up onsprite loginanyway.