Commands

Global flags

These flags are available on all commands.

Flag	Description
`--telemetry`, `-t`	Enable or disable anonymous usage telemetry.
`--help`, `-h`	Display help for the command.
`--version`, `-v`	Display the CLI version. Alias for `mint version`.

`mint dev`

Start a local preview of your documentation.

mint dev [flags]

Flag	Description
`--port`	Port to run the local preview on. Defaults to `3000`.
`--no-open`	Do not open the browser automatically.
`--groups`	Comma-separated list of user groups to mock for preview.
`--disable-openapi`	Skip OpenAPI file processing to improve performance.
`--local-schema`	Allow locally hosted OpenAPI files served over HTTP.

Authenticate with your Mintlify account.

mint login

Opens a browser window to complete authentication. If the browser does not open, the CLI displays a URL to open manually and a prompt to paste the authorization code. Credentials save in ~/.config/mintlify/config.json. If you have more than one deployment, the CLI prompts you to select a default after you log in. You can change the default project later with mint config set subdomain <subdomain>.

`mint logout`

Remove stored credentials.

mint logout

`mint status`

Display your current session details including CLI version, account email, organization, and configured subdomain.

mint status

`mint automations`

Create, list, and delete automations from the terminal. Requires authentication with mint login.

mint automations <subcommand> [flags]

mint workflow and mint workflows continue to work as aliases for mint automations, so existing scripts keep running. New scripts should use mint automations.

All subcommands accept these shared flags:

Flag	Description
`--subdomain`	Documentation subdomain. Defaults to the value set with `mint config set subdomain`, or the first project on your account.
`--format`	Output format: `table` (default, pretty) or `json` (raw, machine-readable).

When --format json is set, errors print to stderr as Error: <message> and the command exits with a non-zero status, so you can pipe successful output into other tools.

`mint automations create`

Create a new automation. You can pass the automation definition inline with flags, or point at a JSON or YAML file with --file.

mint automations create [flags]

Flag	Description
`--name`	Automation name. Required unless `--file` is provided.
`--prompt`	Instructions appended to the automation’s base prompt on every run.
`--type`	Automation type. One of `changelog`, `source-code-agent`, `translations`, `writing-style`, `typo-check`, `broken-link-detection`, `seo-metadata-audit`, `assistant-docs-updates`, or `contextual-feedback-docs-updates`. Omit for a custom automation.
`--cron`	Cron expression for a scheduled trigger. Mutually exclusive with `--push-repo`.
`--push-repo`	Repository (`owner/repo`) for a push trigger. Repeatable to listen to multiple repositories. Mutually exclusive with `--cron`.
`--context-repo`	Additional context repository (`owner/repo`) the agent reads when the automation runs. Repeatable, up to 10 total.
`--automerge`	Automatically merge pull requests opened by this automation. See Configure automerge for setup requirements.
`--file`	Path to a JSON or YAML file containing the full automation body. Overrides the inline flags.

Provide exactly one trigger: pass --cron for a scheduled automation or one or more --push-repo flags for a push-triggered automation.

Examples

# Scheduled translations automation
mint automations create \
  --name "Translate content" \
  --type translations \
  --cron "0 6 * * *"

# Push-triggered automation with extra context
mint automations create \
  --name "Sync API reference" \
  --type source-code-agent \
  --push-repo my-org/api \
  --context-repo my-org/shared-types \
  --automerge

# Create from a file
mint automations create --file automation.yaml

An automation file uses the same shape as the inline flags. The on field holds the trigger:

name: Translate content
type: translations
on:
  cron: "0 6 * * *"
prompt: Prefer formal tone in French translations.
automerge: false
context:
  - repo: my-org/shared-content

`mint automations list`

List automations for the current deployment.

mint automations list [flags]

The default table output shows each automation’s ID, name, type, trigger, and status. Use --format json to get the full automation objects.

`mint automations delete`

Delete an automation by ID. Use mint automations list to get the ID.

mint automations delete <id> [flags]

Argument	Description
`id`	Automation schema ID to delete.

`mint config`

Manage persistent default values for CLI commands. The configuration saves in ~/.config/mintlify/config.json.

mint config <subcommand> <key> [value]

Subcommand	Description
`set <key> <value>`	Set a configuration value.
`get <key>`	Display a configuration value.
`clear <key>`	Remove a configuration value.

Configuration keys

Key	Description	Used by
`subdomain`	Default documentation subdomain.	`mint automations`

`mint broken-links`

Check for broken internal links in your documentation.

mint broken-links [flags]

The command scans .mdx and .md files for links and excludes files matching .mintignore patterns. Links inside OpenAPI specification files (.yaml, .yml, .json) are not checked. Links that point to ignored files report as broken.

Flag	Description
`--check-anchors`	Also validate anchor links (for example, `/page#section`) against heading slugs.
`--check-external`	Also check external URLs for broken links.
`--check-redirects`	Also check that redirect destinations in `docs.json` resolve to valid paths.
`--check-snippets`	Also check links inside `<Snippet>` components.

Check for accessibility issues in your documentation.

mint a11y [flags]

Checks color contrast ratios and missing alt text on images and videos.

Flag	Description
`--skip-contrast`	Skip color contrast checks.
`--skip-alt-text`	Skip missing alt text checks.

`mint validate`

Validate your documentation build in strict mode. Exits with an error if there are any warnings or errors. Includes automatic validation of OpenAPI specifications referenced in your docs.json.

mint validate [flags]

Flag	Description
`--groups`	Comma-separated list of user groups to mock for validation.
`--disable-openapi`	Skip OpenAPI file processing and validation.
`--local-schema`	Allow validation of locally hosted OpenAPI files served over HTTP. Only supports HTTPS in production.

Use mint validate instead of the deprecated standalone mint openapi-check command.

`mint export`

Export your documentation as a self-contained zip archive for offline viewing and distribution.

mint export [flags]

Flag	Description
`--output`	Output filename. Defaults to `export.zip`.
`--groups`	Comma-separated list of user groups to include restricted pages for.
`--disable-openapi`	Skip OpenAPI processing.

See Offline export for details.

`mint score`

Run agent readiness checks against a public documentation site. Requires authentication with mint login.

mint score [url] [flags]

Argument	Description
`url`	Optional. URL of the docs site to check. If omitted, the command scores your configured subdomain (from `mint config` or the subdomain associated with your logged-in account).

Flag	Description
`--format`	Output format: `table` (default, colored), `plain` (pipeable TSV), or `json`.

The command displays an overall readiness score and a breakdown of individual checks with pass/fail indicators.

Examples

# Score your default subdomain
mint score

# Score a specific site
mint score docs.example.com

Checks

The score evaluates the following areas:

Check	What it verifies
`llmsTxtExists`	Agents can reach an llms.txt file at the site root.
`llmsTxtValid`	The `llms.txt` file follows the expected format with headings, blockquote summary, and Markdown links.
`llmsTxtSize`	The `llms.txt` file is within the size threshold so agents can consume it without truncation.
`llmsTxtLinksResolve`	Links inside `llms.txt` resolve to live pages.
`llmsTxtLinksMarkdown`	Links inside `llms.txt` use Markdown syntax.
`llmsTxtDirective`	The `llms.txt` file contains usage directives.
`llmsTxtFullExists`	An llms-full.txt file is available for agents that need the complete content. Runs independently of `llmsTxtExists`.
`llmsTxtFullSize`	The `llms-full.txt` file is within a reasonable size for agents to process.
`llmsTxtFullValid`	The `llms-full.txt` file contains valid content with headings.
`llmsTxtFullLinksResolve`	Links inside `llms-full.txt` resolve to live pages.
`skillMd`	Agents can reach a skill.md file for agent tool use.
`contentNegotiationMarkdown`	The site returns Markdown when agents request it through content negotiation.
`contentNegotiationPlaintext`	The site returns plain text when agents request it through content negotiation.
`mcpServerDiscoverable`	Agents can discover an MCP server for tool-based agents.
`mcpToolCount`	The MCP server exposes at least one tool.
`openApiSpec`	There is an available OpenAPI or Swagger specification at a standard path.
`robotsTxtAllowsAI`	The `robots.txt` file does not block AI crawlers.
`sitemapExists`	There is a sitemap available for page discovery.
`structuredData`	The homepage contains JSON-LD structured data (`<script type="application/ld+json">`). Reports the number of JSON-LD blocks and the schema types found.
`responseLatency`	The site responds within an acceptable time for agents.

Some checks only run if a check they depend on passes. If a check fails, none of the checks that depend on it run. They automatically fail. For example, llmsTxtValid only passes if llmsTxtExists passes first. The overall score uses weighted scoring, so higher-impact checks contribute more to your score.

`mint deslop`

Detect AI-sounding prose in documentation pages and get humanization suggestions. Requires authentication with mint login.

mint deslop [files..] [flags]

With no arguments, the command checks git-changed .md and .mdx pages (staged, unstaged, and untracked). In a docs repo with a docs.json, changed files are automatically filtered to the pages referenced in your navigation, so .mintignored and unpublished pages are skipped. You can also pass explicit file paths or globs. Each page is scored on the fraction of prose that reads as AI-written. Pages that meet or exceed --threshold fail, and the command exits with status 1 if any page is flagged or errors. Fully-human pages never fail, even at --threshold 0.

Argument	Description
`files`	Optional. One or more file paths or globs to check. Defaults to git-changed pages.

Flag	Description
`--subdomain`	Documentation subdomain. Defaults to the value set with `mint config set subdomain`.
`--format`	Output format: `table` (default, colored), `plain` (pipeable), or `json` (agent-friendly).
`--threshold`	Fail a page when its AI-written fraction meets this value. Number between `0` and `1`. Defaults to `0.5`.
`--fix-whitespace`	Normalize prose whitespace in the checked files before scoring. Rewrites files locally with no server call.

For each flagged page, the output shows the AI-written percentage, the flagged line ranges, the offending prose, and suggested rewrites you can apply.

Checking pages consumes AI credits. --fix-whitespace runs locally and does not charge credits. If the batch hits a credits or availability error, the remaining pages are skipped instead of retried.

Examples

# Check git-changed pages
mint deslop

# Check a specific page
mint deslop docs/guide.mdx

# Check pages by glob with agent-friendly output
mint deslop "docs/**/*.mdx" --format json

# Fail only on the most confidently AI-written pages
mint deslop --threshold 0.8

# Normalize prose whitespace and re-check in one pass
mint deslop --fix-whitespace

Fixing whitespace

--fix-whitespace deterministically cleans prose whitespace in each checked file: trailing spaces, runs of blank lines, unicode and zero-width spaces, and internal double-spaces. Fenced code blocks, inline code, and frontmatter are left untouched. Because it runs locally, it is safe to include in pre-commit hooks or CI.

JSON output

--format json writes a single JSON object to stdout with a results array (one entry per file, keyed by path) and a summary block. Errors are reported per file and counted in summary.errors. This shape is designed for agents that loop: check, rewrite flagged passages, then re-run until the command exits 0. The CLI calls the same detection service exposed by the Admin API. Use the check page for AI-sounding prose endpoint if you need to run these checks from a CI pipeline or internal tool without shelling out to the CLI.

`mint new`

Create a new documentation project by picking a theme or cloning a pre-defined template from the mintlify/templates repository.

mint new [directory] [flags]

Flag	Description
`--name`	Project name. The CLI prompts for this if not provided in interactive mode.
`--theme`	Project theme. The CLI prompts for this if not provided in interactive mode.
`--template`	Pre-defined template. The CLI prompts for this if not provided in interactive mode.
`--force`	Overwrite the directory without prompting.

`mint update`

Update the CLI to the latest version.

mint update

`mint version`

Display the current CLI and client versions.

mint version

Coming soon

These commands are available to run but are not yet functional. Running them records your interest through CLI telemetry and helps prioritize what ships next.

Command	Description
`mint ai`	AI-powered documentation tools.
`mint test`	Documentation testing.
`mint signup`	Account sign-up from the CLI.
`mint mcp`	MCP server for documentation.

Telemetry

The CLI collects anonymous usage telemetry to help improve Mintlify. Telemetry data includes the command name, CLI version, operating system, and architecture. Mintlify does not collect personally identifiable information, project content, or file paths. By default, the CLI collects telemetry data. You can opt out at any time using the --telemetry flag:

# Disable telemetry
mint --telemetry false

# Re-enable telemetry
mint --telemetry true

You can also disable telemetry by setting one of these environment variables:

Variable	Value	Description
`MINTLIFY_TELEMETRY_DISABLED`	`1`	Disable Mintlify CLI telemetry.
`DO_NOT_TRACK`	`1`	Disable telemetry using the Console Do Not Track standard.

Your preference saves in ~/.config/mintlify/config.json and persists across CLI sessions.

Get started

Organize

Customize

Create content

Document APIs

Deploy

Optimize

Global flags

`mint dev`

`mint logout`

`mint status`

`mint automations`

`mint automations create`

Examples

`mint automations list`

`mint automations delete`

`mint config`

Configuration keys

`mint broken-links`

`mint validate`

`mint export`

`mint score`

Examples

Checks

`mint deslop`

Examples

Fixing whitespace

JSON output

`mint new`

`mint update`

`mint version`

Coming soon

Telemetry

​Global flags

​mint dev

​mint login

​mint logout

​mint status

​mint automations

​mint automations create

​Examples

​mint automations list

​mint automations delete

​mint config

​Configuration keys

​mint broken-links

​mint a11y

​mint validate

​mint export

​mint score

​Examples

​Checks

​mint deslop

​Examples

​Fixing whitespace

​JSON output

​mint new

​mint update

​mint version

​Coming soon

​Telemetry

Global flags

`mint dev`

`mint login`

`mint logout`

`mint status`

`mint automations`

`mint automations create`

Examples

`mint automations list`

`mint automations delete`

`mint config`

Configuration keys

`mint broken-links`

`mint a11y`

`mint validate`

`mint export`

`mint score`

Examples

Checks

`mint deslop`

Examples

Fixing whitespace

JSON output

`mint new`

`mint update`

`mint version`

Coming soon

Telemetry