Your agent can now publish your docs

Mintlify released a `mint deploy` CLI command that lets coding agents such as Claude Code, Cursor, and Codex publish a live documentation site from the terminal without an account or GitHub repository, with the site expiring 24 hours after creation unless claimed. The agent runs `npm i -g mint` then `mint deploy --subdomain acme` to create a Mintlify-hosted Git repository and short-lived write token, pushing docs live at acme.mintlify.site; a `--github` flag instead writes a GitHub Actions workflow for an existing repository. Mintlify said its evals showed agents previously built sites locally but stalled at email verification and GitHub setup, and the new flow lets the agent send a claim link that the user completes via `mint claim --email` and `mint claim --code`, with deploying free and claiming a first site starting a Pro trial.

Denzell Ford Engineering Share this article Denzell Ford Engineering Share this article Ask Claude Code, Cursor, or Codex to document a repository and it can write the pages in minutes. Ask it to put them online, and until now, the agent eventually handed the job back to you. In our evals, agents built the site locally, reached signup, then told the user to finish the flow in a browser. Email verification and GitHub setup were human-only steps. mint deploy https://www.mintlify.com/docs/cli/agent-signup removes that handoff. An agent can publish a live Mintlify site from the terminal without an account or GitHub repository, then send you a link to claim the site within 24 hours. From prompt to live docs from-prompt-to-live-docs From the folder that holds docs.json , the agent runs: npm i -g mint mint deploy --subdomain acme The CLI creates a Mintlify-hosted Git repository and returns a short-lived write token. The agent pushes your docs, and the site goes live at acme.mintlify.site . You do not need to create an account or connect GitHub before the first deployment. Deploy with or without GitHub deploy-with-or-without-github The default flow gives the agent a Mintlify-hosted repository. If you want your docs to live in an existing GitHub repository, use: mint deploy --github --subdomain acme This writes a GitHub Actions workflow that updates the site when you push to the default branch. If your docs live in a subdirectory, pass it with --directory . Claim the site within 24 hours claim-the-site-within-24-hours The site is already live when the claim flow begins. Claiming moves it into your Mintlify dashboard so you can keep managing it. 1. The agent needs your email to run mint claim --email jane@acme.com . 2. You open the claim link and sign in or create an account. 3. You copy the code on the page and paste it back to the agent. 4. The agent completes the claim with mint claim --code 4F7K-9QX2 . Claiming makes you an admin of the site's organization. Try it with your agent try-it-with-your-agent Open Claude Code, Cursor, or Codex in the folder that contains docs.json and paste this prompt: Install the Mintlify CLI with npm i -g mint, then publish the docs in this folder with mint deploy. Push the files, check that the site loads, and send me the live URL. Remind me to claim the site within 24 hours. Run mint deploy --help to see every option, or read the agent signup docs https://www.mintlify.com/docs/cli/agent-signup . If you have any other ideas to improve your agentic workflow, add them to the roadmap https://www.mintlify.com/roadmap . Frequently Asked Questions frequently-asked-questions How does an agent know what to do? how-does-an-agent-know-what-to-do Agents can discover the flow through mintlify.com/auth.md https://mintlify.com/auth.md . auth.md https://workos.com/auth-md is an open protocol from WorkOS that explains how an agent can register with a service and hand the resulting account to a person. Mintlify's file describes the same flow as raw HTTP requests, so agents that cannot install the CLI can still register, provision a site, and hand it to you through the claim page. Which agents does this work with? which-agents-does-this-work-with Any agent that can run shell commands, npm, and Git, including Claude Code, Cursor, and Codex. What does it cost? what-does-it-cost Deploying is free. If this is your first Mintlify site, claiming it starts a Pro trial. What happens if I do not claim the site? what-happens-if-i-do-not-claim-the-site It expires 24 hours after creation and is deleted, along with its hosted repository. To start over, run mint deploy --new --subdomain <name to create a new site. What if I already have a Mintlify account? what-if-i-already-have-a-mintlify-account Sign in with your existing account and the site will appear in your dashboard. If you belong to several organizations, the claim page may ask you to choose one. Can I move a claimed site to my own GitHub repository? can-i-move-a-claimed-site-to-my-own-github-repository Yes. After you claim a site, open the Git settings in your dashboard https://app.mintlify.com and connect your repository. mint deploy --github only works for sites that have not been claimed yet. More blog posts to read AI TrendsPF https://www.mintlify.com/blog/self-updating-external-docs-is-an-infinite-market Self-updating external docs is an infinite market Product surface areas are growing exponentially, agents are becoming the main users of docs, and external agents can't read your primary sources. Together, these make self-updating external docs an infinite market. October 25, 2026 Patrick Foster Software Engineer AnnouncementsDI https://www.mintlify.com/blog/bring-your-own-skills Bring your own skills to the Mintlify agent You can now upload custom skills to the agent in the web editor. Give it your style guide, review checklist, or page templates once, and it uses them whenever a task calls for them. October 23, 2026 David Isquick Product Marketing