Skip to main content
The agent is available on Pro and Enterprise plans.
The Linear integration lets you delegate issues directly to the Mintlify agent. When you assign an issue to the agent in Linear, it reads the issue details, reviews your documentation, and opens a pull request with the relevant changes.

​
How it works

  1. You delegate a Linear issue to the Mintlify agent or @mention it in an issue thread.
  2. The agent reads the issue title, description, and any comments for context.
  3. It reviews your existing documentation and determines what needs to change.
  4. If documentation changes are needed, the agent opens a pull request and moves the issue to In Review.
  5. If no changes are needed, the agent explains why.
You can continue the conversation by sending follow-up messages in the agent thread on the issue. The agent reuses its existing session, so it remembers the context from previous interactions on the same issue.

​
Connect your Linear workspace

  1. Open the Agent page in your dashboard.
  2. Click the Settings button.
  3. In the Linear integration section, click Connect.
  4. Follow the Linear prompts to authorize the Mintlify app in your workspace.
  5. Once connected, the dashboard shows your Linear organization name.

​
Use the agent in Linear

​
Delegate an issue

To trigger the agent, delegate a Linear issue to it. The agent picks up the issue, analyzes the title and description, and determines what documentation changes are needed. If the issue description includes specific instructions, the agent follows them. Otherwise, it uses its judgment to decide what documentation updates are appropriate.

​
Send follow-up messages

After the agent processes an issue, you can send follow-up messages in the agent thread to:
  • Ask for additional changes to the pull request.
  • Provide more context or clarify your request.
  • Request a different approach to the documentation update.
The agent picks up each follow-up in the same session, so it has full context of the conversation.

​
Stop the agent

If the agent is processing an issue and you want to stop it, use Linear’s stop signal. The agent stops its current work and marks the run as complete.

​
Disconnect Linear

  1. Open the Agent page in your dashboard.
  2. Click the Settings button.
  3. In the Linear integration section, click Disconnect.
You can also revoke access from your Linear workspace settings. Revoking the app authorization in Linear automatically removes the integration from Mintlify.