From 9ca51b7a9ee4930b89bf8c4a0de1647933e5e24b Mon Sep 17 00:00:00 2001
From: "mintlify-development[bot]"
 <109878554+mintlify-development[bot]@users.noreply.github.com>
Date: Sat, 6 Dec 2025 03:23:51 +0000
Subject: [PATCH] Update ai/agent.mdx

---
 ai/agent.mdx | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/ai/agent.mdx b/ai/agent.mdx
index 0b51d12c3..65b117776 100644
--- a/ai/agent.mdx
+++ b/ai/agent.mdx
@@ -55,6 +55,23 @@ You can also use the agent in Slack to collaborate with your team on documentati
    - Send a direct message to it.
    - Mention it with `@mintlify` in a channel.
 
+## Use the agent in GitHub pull requests
+
+You can mention `@mintlify` in comments on pull requests in your documentation repository to trigger the agent directly from GitHub.
+
+When you mention `@mintlify` in a PR comment, the agent:
+
+1. Adds an eyes reaction (👀) to your comment to indicate it's processing your request
+2. Analyzes your prompt and the PR context
+3. Creates commits with the requested changes directly to the PR branch
+4. Replaces the eyes reaction with a thumbs up (👍) when complete
+
+This works for both:
+- **Issue comments**: General comments on the pull request
+- **Review comments**: Comments on specific lines of code in the Files Changed view
+
+The agent only responds to `@mintlify` mentions on pull requests in repositories connected to your documentation deployment.
+
 ## Connect repositories as context
 
 The agent can only access repositories that you connect through the Mintlify GitHub App. Configure which repositories the agent can access in the agent panel **Settings** or in the [GitHub App settings](https://github.com/apps/mintlify/installations/new).