mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
mintlify[bot]
b9cfd7824b
* Add AI tool tips and skill.md install prompts to key pages Generated-By: mintlify-agent * Apply suggestion from @ethanpalm --------- Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
57 lines
3.0 KiB
Plaintext
57 lines
3.0 KiB
Plaintext
---
|
|
title: "Mintlify CLI"
|
|
description: "Use the Mintlify CLI to preview docs locally, test changes in real time, analyze site performance, and run quality checks before deploying."
|
|
keywords: ["CLI", "mint", "local development", "preview", "analytics"]
|
|
---
|
|
|
|
<img
|
|
className="block dark:hidden my-0 pointer-events-none"
|
|
src="/images/installation/local-development-light.png"
|
|
alt="Decorative graphic representing the CLI."
|
|
/>
|
|
<img
|
|
className="hidden dark:block my-0 pointer-events-none"
|
|
src="/images/installation/local-development-dark.png"
|
|
alt="Decorative graphic representing the CLI."
|
|
/>
|
|
|
|
## About the CLI
|
|
|
|
Use the [CLI](https://www.npmjs.com/package/mint) to preview your documentation locally, test changes in real time, analyze site performance, 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.
|
|
|
|
### Analyze your documentation
|
|
Run `mint analytics` to view traffic, search queries, user feedback, and AI assistant conversations directly from the terminal. Useful for quick checks, scripting, and piping data into other tools.
|
|
|
|
### 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 and date ranges for analytics commands.
|
|
|
|
<Tip>
|
|
Working on your docs locally with an AI coding tool? Install the Mintlify [skill](/ai/skillmd) and [MCP server](/ai/model-context-protocol) so your editor has the context it needs to write Mintlify-aware content.
|
|
</Tip>
|
|
|
|
<Prompt description="Install the Mintlify skill and MCP server for AI coding tools." actions={["copy", "cursor"]}>
|
|
Install the Mintlify skill to get context on Mintlify project structure, components, and documentation best practices:
|
|
|
|
npx skills add https://mintlify.com/docs
|
|
|
|
Then add the Mintlify MCP server for access to documentation search. Follow the setup instructions at https://www.mintlify.com/docs/ai/model-context-protocol.md
|
|
</Prompt>
|
|
|
|
## Next steps
|
|
|
|
- [Install the CLI](/cli/install): Get the CLI installed and ready to use.
|
|
- [Preview locally](/cli/preview): Run a local development server with search and assistant support.
|
|
- [Analyze your documentation](/cli/analytics): View analytics data from the terminal.
|
|
- [Commands](/cli/commands): Complete reference for all commands and flags.
|