Skip to main content
Decorative graphic representing the CLI.

​
About the CLI

Use the CLI to preview your documentation locally, test changes in real time, and run quality checks before deploying to production. The CLI runs on your machine and connects to your Mintlify deployment when you need live data.

​
Preview locally

Run mint dev to preview your documentation at localhost:3000. As you write and update your content, changes appear in real time without deploying. Log in to enable search and the AI assistant in your local preview.

​
Run quality checks

Run mint broken-links to find broken links, mint a11y to check accessibility, and mint validate to validate your documentation build before it reaches production.

​
Check agent readiness

Run mint score to evaluate how well agents can navigate a documentation site. With no arguments, the command scores your configured subdomain. Pass a URL to score any other site. The command displays an overall readiness score and individual check results.

​
Manage configuration

Run mint config to set persistent defaults like your documentation subdomain.
Working on your docs locally with an AI coding tool? Install the Mintlify skill and MCP server so your editor has the context it needs to write Mintlify-aware content.

Install the Mintlify skill and MCP servers for AI coding tools.

Open in Cursor

​
Next steps

  • Install the CLI: Get the CLI installed and ready to use.
  • Preview locally: Run a local development server with search and assistant support.
  • Commands: Complete reference for all commands and flags.