diff --git a/agent/index.mdx b/agent/index.mdx
index eff14bee2..5619bcf18 100644
--- a/agent/index.mdx
+++ b/agent/index.mdx
@@ -45,6 +45,9 @@ The agent can only access repositories that you connect through the Mintlify Git
Add the agent to your Slack workspace.
+
+Delegate Linear issues to the agent.
+
Configure the agent with an `AGENTS.md` file.
diff --git a/agent/linear.mdx b/agent/linear.mdx
new file mode 100644
index 000000000..3a8fafd53
--- /dev/null
+++ b/agent/linear.mdx
@@ -0,0 +1,59 @@
+---
+title: "Connect the agent to Linear"
+description: "Delegate Linear issues to the agent to automatically update your documentation."
+keywords: ["Linear integration", "issue tracking", "agent integration", "documentation automation"]
+---
+
+
+ The agent is available on [Pro and Enterprise plans](https://mintlify.com/pricing?ref=agent).
+
+
+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](https://dashboard.mintlify.com/products/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](https://dashboard.mintlify.com/products/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.
diff --git a/docs.json b/docs.json
index 0d53e0a0d..272d69e7c 100644
--- a/docs.json
+++ b/docs.json
@@ -93,6 +93,7 @@
"root": "agent/index",
"pages": [
"agent/slack",
+ "agent/linear",
"agent/workflows",
"agent/customize",
"agent/effective-prompts",