From b1f73e849bc4c9195f2982547a3e59b1e0c37afd Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 11 Mar 2026 22:01:06 +0000 Subject: [PATCH 1/4] Add --no-open and --local-schema CLI flag documentation Generated-By: mintlify-agent --- installation.mdx | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) diff --git a/installation.mdx b/installation.mdx index e55113e55..b0fc1fd13 100644 --- a/installation.mdx +++ b/installation.mdx @@ -81,7 +81,11 @@ Navigate to your documentation directory containing your `docs.json` file and ru mint dev ``` -A local preview of your documentation is available at `http://localhost:3000`. +A local preview of your documentation is available at `http://localhost:3000`. By default, the browser opens automatically. To prevent the browser from opening, use the `--no-open` flag: + +```bash +mint dev --no-open +``` Alternatively, if you do not want to install the CLI globally, you can run a one-time script: @@ -232,6 +236,14 @@ mint openapi-check Pass a filename (for example, `./openapi.yaml`) or a URL (for example, `https://petstore3.swagger.io/api/v3/openapi.json`). +To check a locally hosted OpenAPI file served over HTTP, use the `--local-schema` flag: + +```bash +mint openapi-check http://localhost:8080/openapi.json --local-schema +``` + +Only HTTPS URLs are supported in production deployments. The `--local-schema` flag is for local development only. + ### Create a workflow Create a [workflow](/agent/workflows) file interactively with the following command: From ecd8bb0fd1ca6ec241dff495a49dc4a876d77192 Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Wed, 11 Mar 2026 17:10:59 -0700 Subject: [PATCH 2/4] Apply suggestion from @ethanpalm --- installation.mdx | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/installation.mdx b/installation.mdx index b0fc1fd13..8b61c49ad 100644 --- a/installation.mdx +++ b/installation.mdx @@ -81,11 +81,12 @@ Navigate to your documentation directory containing your `docs.json` file and ru mint dev ``` -A local preview of your documentation is available at `http://localhost:3000`. By default, the browser opens automatically. To prevent the browser from opening, use the `--no-open` flag: +A local preview of your documentation is available at `http://localhost:3000`. + +By default, the browser opens automatically. To prevent the browser from opening, use the `--no-open` flag: ```bash mint dev --no-open -``` Alternatively, if you do not want to install the CLI globally, you can run a one-time script: From 198da7867a0ad8253479674b957d824eba22c1a7 Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Wed, 11 Mar 2026 17:12:00 -0700 Subject: [PATCH 3/4] fix code block --- installation.mdx | 1 + 1 file changed, 1 insertion(+) diff --git a/installation.mdx b/installation.mdx index 8b61c49ad..50c4e06e0 100644 --- a/installation.mdx +++ b/installation.mdx @@ -87,6 +87,7 @@ By default, the browser opens automatically. To prevent the browser from opening ```bash mint dev --no-open +``` Alternatively, if you do not want to install the CLI globally, you can run a one-time script: From 863b7f76be0c91dab1d6dd15dc798126f2b81921 Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Wed, 11 Mar 2026 17:12:31 -0700 Subject: [PATCH 4/4] formatting --- installation.mdx | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/installation.mdx b/installation.mdx index 50c4e06e0..6d2cc539e 100644 --- a/installation.mdx +++ b/installation.mdx @@ -244,7 +244,9 @@ To check a locally hosted OpenAPI file served over HTTP, use the `--local-schema mint openapi-check http://localhost:8080/openapi.json --local-schema ``` -Only HTTPS URLs are supported in production deployments. The `--local-schema` flag is for local development only. + + Only HTTPS URLs are supported in production deployments. The `--local-schema` flag is for local development only. + ### Create a workflow