diff --git a/docs/organization/integrations/issue-tracking/sentry-linear-agent/img/Linear-agent-help-options.png b/docs/organization/integrations/issue-tracking/sentry-linear-agent/img/Linear-agent-help-options.png
new file mode 100644
index 00000000000000..74d31027099d43
Binary files /dev/null and b/docs/organization/integrations/issue-tracking/sentry-linear-agent/img/Linear-agent-help-options.png differ
diff --git a/docs/organization/integrations/issue-tracking/sentry-linear-agent/img/Linear-oauth-consent.png b/docs/organization/integrations/issue-tracking/sentry-linear-agent/img/Linear-oauth-consent.png
new file mode 100644
index 00000000000000..dcc89274a15a03
Binary files /dev/null and b/docs/organization/integrations/issue-tracking/sentry-linear-agent/img/Linear-oauth-consent.png differ
diff --git a/docs/organization/integrations/issue-tracking/sentry-linear-agent/img/Linear-run-or-run-always.png b/docs/organization/integrations/issue-tracking/sentry-linear-agent/img/Linear-run-or-run-always.png
new file mode 100644
index 00000000000000..999b2b4acb0c1e
Binary files /dev/null and b/docs/organization/integrations/issue-tracking/sentry-linear-agent/img/Linear-run-or-run-always.png differ
diff --git a/docs/organization/integrations/issue-tracking/sentry-linear-agent/img/Linear-triage-claim.png b/docs/organization/integrations/issue-tracking/sentry-linear-agent/img/Linear-triage-claim.png
new file mode 100644
index 00000000000000..5d4edb3098eae6
Binary files /dev/null and b/docs/organization/integrations/issue-tracking/sentry-linear-agent/img/Linear-triage-claim.png differ
diff --git a/docs/organization/integrations/issue-tracking/sentry-linear-agent/img/Linear-triage-rule.png b/docs/organization/integrations/issue-tracking/sentry-linear-agent/img/Linear-triage-rule.png
new file mode 100644
index 00000000000000..b86b8a5f1732a7
Binary files /dev/null and b/docs/organization/integrations/issue-tracking/sentry-linear-agent/img/Linear-triage-rule.png differ
diff --git a/docs/organization/integrations/issue-tracking/sentry-linear-agent/index.mdx b/docs/organization/integrations/issue-tracking/sentry-linear-agent/index.mdx
index 3fce90deb44944..78874f76537450 100644
--- a/docs/organization/integrations/issue-tracking/sentry-linear-agent/index.mdx
+++ b/docs/organization/integrations/issue-tracking/sentry-linear-agent/index.mdx
@@ -9,7 +9,7 @@ og_image: /og-images/organization-integrations-issue-tracking-sentry-linear-agen
-**Sentry Agent for Linear** is in its beta phase. It is currently only available for US-based Sentry.io organizations. Changes to the UX and the agent functionality should be expected.
+**Sentry Agent for Linear** is in its beta phase. Changes to the UX and the agent functionality should be expected.
@@ -24,7 +24,6 @@ This integration highly benefits from having [automation configured within Seer]
Sentry owner, manager, or admin permissions are required to install this integration.
Linear **won't** work with self-hosted Sentry.
-
Navigate to **Settings > Integrations > Linear (Sentry Agent)**, accept and install.
@@ -42,31 +41,87 @@ When the issue is delegated to the agent, the agent will automatically check for
For comment based interactions, the integration accepts natural language. We attempt to parse the intent of the question and trigger the appropriate response. If it fails, we'll prompt the help command that will guide you through options.
-Currently the integration allows the user to run the following actions:
+Most actions are available via interactive buttons or natural language. Currently, the integration allows the user to run the following actions:
- Issue Fix - Runs a Seer Issue Fix for the application.
- Status - Updates the status of the issue.
- Help - Displays the help command that will guide you through options.
+- Enable/Disable automatic Seer runs - Toggle whether Seer automatically runs (without confirmation) when issues are assigned in Linear.
+- Enable/Disable Seer PRs - Allow Seer to open pull requests automatically when fixes are ready.
+
+## Automation & Configuration
+
+When an issue is assigned to the Sentry Agent in Linear, the user will be prompted to link their account with Sentry. This creates the relationship between your Linear user and your Sentry user, and exposes the projects and Sentry resources the user has access to.
+
+The OAuth consent screen shows what orgnaization is connecting to Linear as well as gives options that can be enabled to customize the Sentry Agent in Linear's behavior.
+
+
+
+
+
+
+
+These options can also be managed within the agent interface after the account is linked through the `help` command and leveraging the select menu at the bottom.
+
+
+
+
+
+
+
+These options can also be enabled interactively during agent sessions. These options present themselves in the following ways:
+
+- Via buttons after an issue is assigned:
+ - `Yes, run Seer RCA` runs Seer Root Cause Analysis (RCA) for the current issue
+ - `Yes, and run automatically in the future` enables automatic runs in the future for this workspace and starts Seer RCA for the current issue
+- Natural language controls:
+ - "enable automatic seer runs", "disable automatic seer runs"
+ - "enable Seer PRs", "disable Seer PRs"
## Assigning Sentry Agent to an Issue
1. Navigate to an issue within Linear and select "Assign" from the dropdown menu in the right sidebar.
+
+
+
+
2. Select "Sentry" from the dropdown menu.
3. The task will be moved into in-progress and the Sentry agent session will be created. If it's your first time using the Agent, you'll be prompted to authenticate. Use the "Link" button to link your Linear user to your Sentry user.
-4. Once linked, you'll be asked if you want to run a Seer Issue Fix for the application. You can answer "Yes", or ask for "Help" to see more options.
+4. If auto-run is disabled, you'll see a prompt with buttons:
+
+ - `Yes, run Seer RCA`
+ - `Yes, and run automatically in the future`
+
+ 
+
+
+5. If auto-run is enabled, the Agent will start Seer automatically and confirm it's running. Use "status" to check progress or view results. If an analysis already exists, the Agent will post the latest status or Sentry issue details.
+
+
+
+ 
+
+
+
+
+### Triage Rules
+
+The Sentry Agent supports Linear's triage rules allowing you to tag issues with a custom label in Linear, and have it execute the Sentry Agent. Examples are below.
+
+#### Triage Configuration
- 
+
-5. If you answer "Yes", the Agent will run a Seer Issue Fix for the application. **Note**: You may need to prompt it for "Status" to see the results.
+#### Triage Action
- 
+
## Uninstalling the Integration
diff --git a/docs/platforms/react-native/integrations/plugin.mdx b/docs/platforms/react-native/integrations/plugin.mdx
index a1618b4a0f25cd..2336c1e0292121 100644
--- a/docs/platforms/react-native/integrations/plugin.mdx
+++ b/docs/platforms/react-native/integrations/plugin.mdx
@@ -126,4 +126,4 @@ Sentry.init({
});
```
-For more information, please refer to [the Supabase integration documentation for the JavaScript SDK](/platforms/javascript/configuration/integrations/supabase/).
+For more information, please refer to [the Supabase integration documentation for the JavaScript SDK](javascript/guides/node/configuration/integrations/supabase/).