Skip to content

docs: claim with mint claim and Confirm - #8335

Draft
cdxker wants to merge 2 commits into
mainfrom
denzell/setup-claim-confirm
Draft

cdxker wants to merge 2 commits into
mainfrom
denzell/setup-claim-confirm

Conversation

@cdxker

@cdxker cdxker commented Nov 6, 2026 •

Copy link
Copy Markdown
Contributor

Update the agent claim instructions to mint claim + Confirm, with no email ask and no code relay.

clank context (clickme)

Description

Agents no longer ask for an email or relay a code: they run mint claim, and the person signs in with any account and clicks Confirm.

  • setup.mdx, skill.md, snippets/agent-setup-workflow.mdx, mint-instructions/*: site and base claim steps use mint claim; --email is only a sign-in prefill.
  • cli/commands.mdx, cli/agent-signup.mdx: flag table, examples, and claim steps match the new CLI; --code documented as legacy.
  • agent-context/.../SKILL.md and reference/cli.md: same copy, so the synced skill bundle picks it up.

Test Plan

  • node .github/scripts/check-mint-instructions.mjs (20 topics OK)
  • After https://github.com/mintlify/mint/pull/14436 ships: npx -y mint@latest deploy, then npx -y mint@latest claim, open the link signed in, click Confirm, and land in the new org.

Pairs with https://github.com/mintlify/server/pull/10554 (Confirm claim + auth.md), https://github.com/mintlify/mint/pull/14436 (CLI + claim page), and https://github.com/mintlify/server/pull/10483 (auth.md base section). Merge after those ship.

Warning

Callouts / Workarounds

  • Only English pages changed; es/fr/zh copies still describe the email + code flow until translations regenerate.

Note

Low Risk
Documentation-only changes to agent/setup copy; no runtime or auth code in this repo (depends on coordinated server/CLI releases).

Overview
Updates agent and CLI documentation so site/base claiming matches the new Confirm flow (no email prompt, no code handoff).

Across skill.md, agent-context/.../SKILL.md, mint-instructions/*, setup.mdx, cli/commands.mdx, cli/agent-signup.mdx, and snippets/agent-setup-workflow.mdx, instructions now tell agents to run plain mint claim, share the link, and have the user sign in and click Confirm. --email is documented only as an optional sign-in prefill when the agent already knows the Mintlify account email; --code is framed as legacy for older claim links. Base claiming drops mint deploy --base --email in favor of mint claim with the same browser-only finish. Example handoffs and checklists no longer ask “what email should I use?”

English-only; localized es/fr/zh pages still describe email + code until translations regenerate (called out in the PR).

Reviewed by Cursor Bugbot for commit d735a4f. Bugbot is set up for automated code reviews on this repo. Configure here.

@mintlify

mintlify Bot commented Nov 6, 2026 •

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
Mintlify Docs 🟢 Ready View Preview Nov 7, 2026, 1:59 AM

💡 Tip: Enable Automations to automatically generate PRs for you.

This branch was successfully deployed

1 active deployment
staging — d735a4f7 Deployed Nov 7, 2026 by mintlify[bot]
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.

1 participant