{"slug": "your-agent-can-now-publish-your-docs", "title": "Your agent can now publish your docs", "summary": "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.", "body_md": "Denzell Ford\n\nEngineering\n\n#### Share this article\n\nDenzell Ford\n\nEngineering\n\n#### Share this article\n\nAsk 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.\n\nIn 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.\n\n[`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.\n\n## [From prompt to live docs](#from-prompt-to-live-docs)\n\nFrom the folder that holds `docs.json`, the agent runs:\n\n```\nnpm i -g mint\nmint deploy --subdomain acme\n```\n\nThe 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`.\n\nYou do not need to create an account or connect GitHub before the first deployment.\n\n## [Deploy with or without GitHub](#deploy-with-or-without-github)\n\nThe default flow gives the agent a Mintlify-hosted repository. If you want your docs to live in an existing GitHub repository, use:\n\n```\nmint deploy --github --subdomain acme\n```\n\nThis 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`.\n\n## [Claim the site within 24 hours](#claim-the-site-within-24-hours)\n\nThe site is already live when the claim flow begins. Claiming moves it into your Mintlify dashboard so you can keep managing it.\n\n1. The agent needs your email to run `mint claim --email jane@acme.com` .\n2. You open the claim link and sign in or create an account.\n3. You copy the code on the page and paste it back to the agent.\n4. The agent completes the claim with `mint claim --code 4F7K-9QX2` .\n\nClaiming makes you an admin of the site's organization.\n\n## [Try it with your agent](#try-it-with-your-agent)\n\nOpen Claude Code, Cursor, or Codex in the folder that contains `docs.json` and paste this prompt:\n\nInstall 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.\n\nRun `mint deploy --help` to see every option, or read the [agent signup docs](https://www.mintlify.com/docs/cli/agent-signup).\n\nIf you have any other ideas to improve your agentic workflow, [add them to the roadmap](https://www.mintlify.com/roadmap).\n\n## [Frequently Asked Questions](#frequently-asked-questions)\n\n### [How does an agent know what to do?](#how-does-an-agent-know-what-to-do)\n\nAgents 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.\n\nMintlify'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.\n\n### [Which agents does this work with?](#which-agents-does-this-work-with)\n\nAny agent that can run shell commands, npm, and Git, including Claude Code, Cursor, and Codex.\n\n### [What does it cost?](#what-does-it-cost)\n\nDeploying is free. If this is your first Mintlify site, claiming it starts a Pro trial.\n\n### [What happens if I do not claim the site?](#what-happens-if-i-do-not-claim-the-site)\n\nIt 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.\n\n### [What if I already have a Mintlify account?](#what-if-i-already-have-a-mintlify-account)\n\nSign 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.\n\n### [Can I move a claimed site to my own GitHub repository?](#can-i-move-a-claimed-site-to-my-own-github-repository)\n\nYes. 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.\n\n#### More blog posts to read\n\n[AI TrendsPF](https://www.mintlify.com/blog/self-updating-external-docs-is-an-infinite-market)\n\n### Self-updating external docs is an infinite market\n\nProduct 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.\n\nOctober 25, 2026\nPatrick Foster\n\nSoftware Engineer\n\n[AnnouncementsDI](https://www.mintlify.com/blog/bring-your-own-skills)\n\n### Bring your own skills to the Mintlify agent\n\nYou 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.\n\nOctober 23, 2026\nDavid Isquick\n\nProduct Marketing", "url": "https://wpnews.pro/news/your-agent-can-now-publish-your-docs", "canonical_source": "https://www.mintlify.com/blog/mint-deploy", "published_at": "2026-10-28 00:00:00+00:00", "updated_at": "2026-10-29 00:13:14.356351+00:00", "lang": "en", "topics": ["ai-agents", "developer-tools", "ai-tools", "agent-protocols"], "entities": ["Mintlify", "Denzell Ford", "Claude Code", "Cursor", "Codex", "WorkOS", "GitHub"], "also_reported_by": [], "alternates": {"html": "https://wpnews.pro/news/your-agent-can-now-publish-your-docs", "markdown": "https://wpnews.pro/news/your-agent-can-now-publish-your-docs.md", "text": "https://wpnews.pro/news/your-agent-can-now-publish-your-docs.txt", "jsonld": "https://wpnews.pro/news/your-agent-can-now-publish-your-docs.jsonld"}}