feat(skill): teach AuthKit-native agent auth (zero auth agent register/claim)#64
Closed
spencercharest wants to merge 1 commit into
Closed
Conversation
…ter`/`claim` (ZERO-483) The bundled zero skill now encodes the human-vs-autonomous decision rule before any auth command: a present human means `zero auth login` (device flow; `register` is an alias), fully autonomous means `zero auth agent register` (anonymous account + managed wallet, no browser), and `agent register` is never a way to sign a human in. Adds the claim handoff section (`zero auth agent claim <email>`): the hosted page shows the HUMAN a pairing code, they read it back, and the agent completes — inline on a TTY or via the two-invocation `--code` pattern — after which credentials rotate automatically. States the registration facts: wallet created at signup (fund with `zero wallet fund`), claim token + expiry recorded in ~/.zero/config.json, unclaimed accounts cleaned up after the registration expires. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Collaborator
Author
|
Consolidated into #65 (same feature surface, one 1.9.0 release): the skill update lands there merged on top of main's attribution-token changes, with the version bump redone against 1.8.0. |
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.
Closes ZERO-483. Follows piedotorg/zero#748 (ZERO-477), which shipped the AuthKit-native agent auth surface in the CLI.
What changed
The bundled
zeroskill now teaches the new onboarding surface:zero auth login(device flow; creates the account on first sign-in;zero auth registeris an alias), fully autonomous →zero auth agent register(anonymous account + managed wallet, no browser), and neveragent registerto sign a human in — it mints an account owned by no one.zero auth agent register --json: session persisted like any login, managed wallet created at signup (fund withzero wallet fund,--no-openfor the one-time URL), claim token + expiry recorded in~/.zero/config.json(claimTokenExpires), unclaimed accounts cleaned up after the registration expires.zero auth agent claim <email>: explicitly the reverse of the device flow — the hosted page shows the human the pairing code, they read it back, the agent completes inline (TTY) or with the second-invocation--code <code>pattern. Notes that re-running without--codeinvalidates the code in flight, and that post-claim the CLI rotates onto fresh credentials automatically.zero wallet fund --no-open), and the "never create a wallet" guidance is sharpened to "never generate a private-key wallet" so it doesn't read as contradicting the managed wallet that registration creates.No references to pre-release names (
zero auth signup, top-levelzero auth claim, claim polling) — verified by grep.One deviation from the ticket text: the ~7-day claim TTL is WorkOS dashboard config and isn't confirmable from the repo, so instead of hardcoding a number the skill points at the authoritative deadline the CLI already surfaces (printed at registration and stored as
claimTokenExpires).Skill content is shipped by the plugin, so this bumps all manifests 1.3.3 → 1.4.0 (
make minor).Verification
Command surface checked against the installed
@zeroxyz/cli1.15.0 (zero auth --help,zero auth agent register/claim --help,zero wallet fund --help) and against the ZERO-477 branch source (packages/cli/src/commands/auth-command.ts,devdocs/auth.md).🤖 Generated with Claude Code