Ask agent

The editor includes a built-in agent that can edit pages, reorganize navigation, update docs.json, search across your entire repository, and manage dashboard settings. The editor agent makes changes directly in your current branch.

​

Open the agent

Click Ask agent in the editor toolbar, or press Cmd + I (macOS) or Ctrl + I (Windows). To close the panel, click the X button in the panel header or press Cmd + I again.

​

Send a message

Type your request in the chat box at the bottom of the panel and press Enter or click the send button. Type @ to mention a specific page. The agent focuses on that page when processing your request. If you don’t mention a page, the agent uses the page you currently have open. Example prompts:

• simplify the introduction page
• fix all grammar errors across my content
• add a new page that explains authentication
• rename every mention of "Acme Pro" to "Acme Team" across all pages
• update docs.json to add a new group called "Guides"

​

Attach files

Click the paperclip icon in the chat box, or drag and drop files onto the panel. The agent reads attached files as context for your request. Supported file types:

• Images: JPG, PNG, GIF, WebP, SVG
• Documents: PDF
• Code and text: .js, .ts, .jsx, .tsx, .mdx, .md, .json, .yaml, .html, .css, Python, Go, Rust, Ruby, Java, Swift, C, C++, SQL, shell scripts, and more

Maximum size: 5 MB per file. Maximum: 10 files per message.

​

Add a selection to the agent

In visual mode, select text on a page. A floating toolbar appears over the selection. Click Add to agent to send the selected text to the agent as context.

​

Review what the agent changed

As the agent edits your pages, a Changed files panel appears in the chat. Expand it to see a list of every file modified in the session. Click any file to open it in diff view and compare the agent’s changes against the original.

​

What the agent can do

​

Edit pages

The agent can write, rewrite, expand, and reorganize content on any page. It reads your existing content to match your style and structure.

​

Search and navigate your content

The agent can search across your entire repository, not just the page you have open. Use it to find information, check for inconsistencies, or verify that content exists before adding it.

​

Update navigation and docs.json

The agent can add, rename, reorder, and delete navigation elements, the same changes you’d make manually in the navigation panel. It can also update docs.json configuration directly, including adding new groups, adjusting settings, and configuring redirects. Example: add a "Quickstart" group under the Getting Started tab and move the quickstart page into it

​

Run bash commands

The agent can run grep, rg, and other bash commands against your repository. Use this for bulk operations that span many files. Example: find every page that mentions the deprecated /v1/auth endpoint

​

Configure your site (code mode)

For requests that go beyond editing pages (setting up authentication, managing workflows, or changing deployment settings), the agent switches into code mode. It writes and runs a script against your Mintlify dashboard on your behalf. Code mode respects your dashboard permissions. If you don’t have access to a setting in the dashboard, the agent can’t change it either. Example prompts that use code mode:

• enable JWT authentication for my site
• create a workflow that updates my site when I merge a PR
• add a custom domain

​

Session history

Click the clock icon in the panel header to see your previous chat sessions. Click any session to reopen it and see what the agent changed.

​

AI instructions

To give the agent persistent guidance like voice rules, terminology, or formatting conventions, configure AI instructions in Editor settings. The agent follows these instructions on every request without you needing to repeat them.