mintlify · mintlify · Apr 3, 2026
diff --git a/.claude/commands/lint-docs.md b/.claude/commands/lint-docs.md
@@ -18,13 +18,9 @@ Commands:
   mint dev                       initialize a local preview environment
   mint openapi-check <filename>  check if an OpenAPI spec is valid
   mint broken-links              check for invalid internal links
-  mint rename <from> <to>        rename a file and update all internal link refe
-                                 rences
   mint update                    update the CLI to the latest version
   mint upgrade                   upgrade mint.json file to docs.json (current fo
                                  rmat)
-  mint migrate-mdx               migrate MDX OpenAPI endpoint pages to x-mint ex
-                                 tensions and docs.json
   mint ai [prompt]               Use ai to document a page
   mint version                   display the current version of the CLI and clie
                                  nt                                 [aliases: v]

diff --git a/.claude/skills/mintlify/SKILL.md b/.claude/skills/mintlify/SKILL.md
@@ -185,7 +185,6 @@ Use `<Columns>` to arrange cards (or other content) in a grid. `cols` accepts 1-
 - `mint dev` — Local preview at localhost:3000.
 - `mint broken-links` — Check internal links.
 - `mint a11y` — Check for accessibility issues.
-- `mint rename` — Rename/move files and update references.
 - `mint validate` — Validate documentation builds.
 - `mint upgrade` — Upgrade from `mint.json` to `docs.json`.
 

diff --git a/guides/migrating-from-mdx.mdx b/guides/migrating-from-mdx.mdx
@@ -1,54 +1,15 @@
 ---
 title: "Migrating MDX API pages to OpenAPI navigation"
 sidebarTitle: "Migrate from MDX to OAS"
 description: "Migrate your manually written MDX API pages to automated OpenAPI-generated documentation with flexible navigation and endpoint grouping."
-keywords: ["API migration", "mint migrate-mdx", "OpenAPI migration", "x-mint extension"]
+keywords: ["API migration", "OpenAPI migration", "x-mint extension"]
 ---
 
 If you are currently using individual MDX pages for your API endpoints, you can migrate to autogenerating pages from your OpenAPI specification while retaining the customizability of individual pages. This can help you reduce the number of files you need to maintain and improve the consistency of your API documentation.
 
 You can define metadata and content for each endpoint in your OpenAPI specification and organize endpoints where you want them in your navigation.
 
-## CLI migration
-
-The `mint migrate-mdx` command is the recommended way to migrate from MDX endpoint pages to autogenerated pages.
-
-This command:
-- Parses your `docs.json` navigation structure.
-- Identifies MDX pages that generate OpenAPI endpoint pages.
-- Extracts content from MDX files and moves it to the `x-mint` extension in your OpenAPI specification.
-- Updates your `docs.json` to reference the OpenAPI endpoints directly instead of MDX files.
-- Deletes the original MDX endpoint files.
-
-<Info>
-If you already have `x-mint` defined for an endpoint and also have an MDX page with content for that endpoint, the MDX content overwrites existing `x-mint` settings.
-
-If you have multiple MDX pages for the same endpoint with different content, the script uses the content from the page that appears last in your `docs.json`.
-
-The migration tool does not support previewing changes before applying them.
-</Info>
-
-<Steps>
-<Step title="Prepare your OpenAPI specification.">
-    Ensure your OpenAPI specification is valid and includes all endpoints you want to document.
-
-    Any MDX pages you want to migrate must have the `openapi:` frontmatter referencing an endpoint.
-
-    <Tip>
-      Validate your OpenAPI file using the [Swagger Editor](https://editor.swagger.io/) or [Mint CLI](https://www.npmjs.com/package/mint).
-    </Tip>
-  </Step>
-  <Step title="Install the Mint CLI">
-    If needed, install or update the [Mint CLI](/installation).
-  </Step>
-  <Step title="Run the migration command.">
-    ```bash
-    mint migrate-mdx
-    ```
-  </Step>
-</Steps>
-
-## Manual migration steps
+## Migration steps
 
 <Steps>
   <Step title="Prepare your OpenAPI specification.">

diff --git a/installation.mdx b/installation.mdx
@@ -17,7 +17,7 @@ keywords: ["CLI", "npm", "local development", "Node.js", "pnpm", "mint dev", "br
 
 Use the [CLI](https://www.npmjs.com/package/mint) to preview your documentation locally as you write and edit. View changes in real-time before deploying, test your documentation site's appearance and features, and catch issues like broken links or accessibility problems.
 
-The CLI also has utilities for maintaining your documentation, including commands to rename files, validate OpenAPI specifications, and migrate content between formats.
+The CLI also has utilities for maintaining your documentation, including commands to validate OpenAPI specifications and check for broken links.
 
 ## Prerequisites
 
@@ -258,30 +258,6 @@ mint workflow
 
 The CLI prompts you for a name, trigger type, and other settings, then creates a `.md` file in `.mintlify/workflows/`.
 
-### Rename files
-
-Rename and update all references to files with the following command:
-
-```bash
-mint rename <path/to/old-filename> <path/to/new-filename>
-```
-
-Use `--force` to rename files and skip errors:
-
-```bash
-mint rename <path/to/old-filename> <path/to/new-filename> --force
-```
-
-### Migrate MDX endpoint pages
-
-Migrate MDX endpoint pages to autogenerated pages from your OpenAPI specification with the following command:
-
-```bash
-mint migrate-mdx
-```
-
-This command converts individual MDX endpoint pages to autogenerated pages defined in your `docs.json`, moves MDX content to the `x-mint` extension in your OpenAPI specification, and updates your navigation. See [Migrating from MDX](/guides/migrating-from-mdx) for detailed information.
-
 ### Export for offline viewing
 
 Export your entire documentation site as a self-contained zip archive for offline viewing and distribution:
@@ -298,40 +274,6 @@ mint export --output customer-docs.zip --groups enterprise
 
 See [Offline export](/deploy/export) for details on all options and distributing the exported archive.
 
-### Import content
-
-Scrape content from an external documentation site or OpenAPI specification using the `mint scrape` commands. This is useful when you migrate your documentation from another platform to Mintlify.
-
-**Import an entire site:**
-
-```bash
-mint scrape <url>
-```
-
-Use the `--filter` (or `-f`) flag to limit scraping to URLs matching a specific path prefix:
-
-```bash
-mint scrape <url> --filter=<path>
-```
-
-**Import a single page:**
-
-```bash
-mint scrape page <url>
-```
-
-**Generate pages from an OpenAPI spec:**
-
-```bash
-mint scrape openapi <openApiFilename or URL>
-```
-
-| Flag | Description |
-| --- | --- |
-| `--outDir` | Directory to write generated files. Defaults to `./docs`. |
-| `--overwrite` | Overwrite existing files. |
-| `--no-writeFiles` | Preview output without writing files. |
-
 ### Upgrade configuration
 
 Convert a `mint.json` configuration file to the current `docs.json` format:

diff --git a/migration.mdx b/migration.mdx
@@ -170,18 +170,12 @@ To migrate your content to Mintlify, you need:
 
 1. If your content is already in Markdown format, copy the content to your Mintlify project. Otherwise, convert your content to MDX format.
 2. Create your `docs.json` referencing the paths to your Markdown pages.
-3. If you have OpenAPI specifications, add them to your `docs.json` and configure the API playground. You can also generate MDX pages from your spec using the `mint scrape openapi` command:
+3. If you have OpenAPI specifications, add them to your `docs.json` and configure the API playground. You can also generate MDX pages from your spec using the [`@mintlify/scraping`](https://www.npmjs.com/package/@mintlify/scraping) package:
 
 ```bash
-mint scrape openapi <openApiFilename or URL>
+npx @mintlify/scraping@latest openapi-file <openApiFilename> -o <folder-name>
 ```
 
-| Flag | Description |
-| --- | --- |
-| `--outDir` | Directory to write generated files. Defaults to `./docs`. |
-| `--overwrite` | Overwrite existing files. |
-| `--no-writeFiles` | Preview output without writing files. |
-
 <Tip>
   If you migrate your content as `.md` files, convert them to `.mdx` to support interactive features like React components.
 </Tip>

diff --git a/skill.md b/skill.md
@@ -55,7 +55,6 @@ Review the Mintlify [components](https://www.mintlify.com/docs/components) to se
 - `mint dev` - Local preview at localhost:3000
 - `mint broken-links` - Check internal links
 - `mint a11y` - Check for accessibility issues in content
-- `mint rename` - Rename/move files and update references
 - `mint validate` - Validate documentation builds
 
 ### Required files