Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion changelog.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -387,7 +387,7 @@ noindex: true
<Update label="April 10, 2026" tags={["New releases","Improvements"]} rss={{ title:"CLI analytics, directory listings, multi-skill support, Slack bot improvements, and more" }}>
## CLI analytics

The [`mint analytics`](/cli/analytics) command lets you view traffic, search queries, user feedback, and assistant conversations from the terminal for better integration with agents.
The `mint analytics` command lets you view traffic, search queries, user feedback, and assistant conversations from the terminal for better integration with agents.

Use subcommands to explore specific data:

Expand Down
130 changes: 0 additions & 130 deletions cli/analytics.mdx

This file was deleted.

107 changes: 2 additions & 105 deletions cli/commands.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Commands"
description: "Complete reference for every Mintlify CLI command and flag, including mint dev, mint build, mint validate, mint analytics, and more."
description: "Complete reference for every Mintlify CLI command and flag, including mint dev, mint build, mint validate, mint broken-links, and more."
keywords: ["CLI", "mint", "commands", "flags", "reference"]
boost: 3
---
Expand Down Expand Up @@ -67,107 +67,6 @@ mint status

---

## `mint analytics`

View analytics data for your documentation. Requires authentication with `mint login`.

```bash
mint analytics <subcommand> [flags]
```

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. |
| `--from` | Start date in `YYYY-MM-DD` format. Defaults to 7 days ago, or the value set with `mint config set dateFrom`. |
| `--to` | End date in `YYYY-MM-DD` format. Defaults to today, or the value set with `mint config set dateTo`. |
| `--format` | Output format: `plain` (default), `table`, `json`, or `graph`. |

### `mint analytics stats`

Display a summary of views, visitors, searches, feedback, and assistant usage.

```bash
mint analytics stats [flags]
```

| Flag | Description |
| --- | --- |
| `--page` | Filter to a specific page path. |

### `mint analytics search`

Display search queries with hit counts and click-through rates.

```bash
mint analytics search [flags]
```

| Flag | Description |
| --- | --- |
| `--query` | Filter by search query substring. |
| `--page` | Filter by top clicked page. |

### `mint analytics feedback`

Display feedback submitted by users.

```bash
mint analytics feedback [flags]
```

| Flag | Description |
| --- | --- |
| `--type` | Feedback type: `page` (aggregate by page) or `code` (code snippet feedback). |
| `--page` | Filter to a specific page path. |

### `mint analytics conversation`

View assistant conversation data.

```bash
mint analytics conversation <subcommand> [flags]
```

#### `mint analytics conversation list`

List assistant conversations. Each entry includes a conversation ID.

```bash
mint analytics conversation list [flags]
```

| Flag | Description |
| --- | --- |
| `--page` | Filter conversations that reference a specific page in sources. |

#### `mint analytics conversation view <conversation-id>`

View a single conversation by ID. Use `mint analytics conversation list` to get IDs.

```bash
mint analytics conversation view <conversation-id>
```

#### `mint analytics conversation buckets list`

List grouped conversation categories. Each entry includes a bucket ID.

```bash
mint analytics conversation buckets list
```

#### `mint analytics conversation buckets view <bucket-id>`

View conversations in a category bucket. Use `mint analytics conversation buckets list` to get IDs.

```bash
mint analytics conversation buckets view <bucket-id>
```

---

## `mint workflow`

Create, list, and delete [workflows](/workflows) from the terminal. Requires authentication with `mint login`.
Expand Down Expand Up @@ -282,9 +181,7 @@ mint config <subcommand> <key> [value]

| Key | Description | Used by |
| --- | --- | --- |
| `subdomain` | Default documentation subdomain. | `mint analytics`, `mint workflow` |
| `dateFrom` | Default start date for analytics queries (`YYYY-MM-DD`). | `mint analytics` |
| `dateTo` | Default end date for analytics queries (`YYYY-MM-DD`). | `mint analytics` |
| `subdomain` | Default documentation subdomain. | `mint workflow` |

---

Expand Down
12 changes: 4 additions & 8 deletions cli/index.mdx
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
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"]
description: "Use the Mintlify CLI to preview docs locally, test changes in real time, and run accessibility, link, and validation checks before deploying."
keywords: ["CLI", "mint", "local development", "preview"]
---

import SkillMcpPrompt from "/snippets/skill-mcp-prompt.mdx";
Expand All @@ -19,24 +19,21 @@ import SkillMcpPrompt from "/snippets/skill-mcp-prompt.mdx";

## 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.
Use the [CLI](https://www.npmjs.com/package/mint) 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.

### 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.
Run `mint config` to set persistent defaults like your documentation subdomain.

<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.
Expand All @@ -48,5 +45,4 @@ Run `mint config` to set persistent defaults like your documentation subdomain a

- [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.
2 changes: 1 addition & 1 deletion cli/preview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@ You must authenticate the CLI with your Mintlify account to enable search and th
mint login
```

After you authenticate with the `mint login` command, the CLI stores your credentials in `~/.config/mintlify/config.json` so you stay logged in across sessions. The CLI also prompts you to select a default project, which commands like `mint analytics` use.
After you authenticate with the `mint login` command, the CLI stores your credentials in `~/.config/mintlify/config.json` so you stay logged in across sessions. The CLI also prompts you to select a default project, which commands like `mint workflow` use.

Once logged in, run `mint dev` to start the local preview with search and the assistant enabled. The assistant uses the same indexed content as your deployed documentation site.

Expand Down
1 change: 0 additions & 1 deletion docs.json
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,6 @@
"pages": [
"cli/install",
"cli/preview",
"cli/analytics",
"cli/commands"
]
},
Expand Down
1 change: 0 additions & 1 deletion es.json
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,6 @@
"pages": [
"es/cli/install",
"es/cli/preview",
"es/cli/analytics",
"es/cli/commands"
]
},
Expand Down
2 changes: 1 addition & 1 deletion es/changelog.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -470,7 +470,7 @@ noindex: true
## Analíticas del CLI
</div>

El comando [`mint analytics`](/es/cli/analytics) te permite ver el tráfico, las consultas de búsqueda, los comentarios de usuarios y las conversaciones del asistente desde la terminal para una mejor integración con agentes.
El comando `mint analytics` te permite ver el tráfico, las consultas de búsqueda, los comentarios de usuarios y las conversaciones del asistente desde la terminal para una mejor integración con agentes.

Usa subcomandos para explorar datos específicos:

Expand Down
Loading
Loading