Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
30 commits
Select commit Hold shift + click to select a range
c9a380d
docs: update Slack app guidance
cursoragent Jul 23, 2026
b60ea13
docs: keep Slack integration docs framework-agnostic
cursoragent Jul 23, 2026
42d2359
docs: align Enterprise Grid warning with Org Owner/Admin roles
cursoragent Jul 23, 2026
1194b28
docs: map legacy webhook events in Slack App migration step
cursoragent Jul 23, 2026
1011164
docs: revert unrelated Actions settings navigation change
cursoragent Jul 23, 2026
b2b62a6
docs: remove organization member Slack permissions note
cursoragent Jul 24, 2026
42eec32
docs: revert Slack webhook documentation changes
cursoragent Jul 24, 2026
9c2762c
docs: restore Playwright Annotations hint in Slack app guide
cursoragent Jul 24, 2026
74de8b9
docs: restore annotation code example in Slack app guide
cursoragent Jul 24, 2026
6d27bf5
docs: restore original Mention Formats table in Slack app guide
cursoragent Jul 24, 2026
a5df176
docs: use third person in Slack PR documentation changes
cursoragent Jul 24, 2026
9a51bf0
Merge branch 'main' into cursor/slack-docs-improvements-770b
cursoragent Jul 28, 2026
96a8ebc
docs: restore third-person Action lifecycle wording in Slack overview
cursoragent Jul 28, 2026
5886cbb
docs: cover ENG-895 Slack run colors, recovery, and live group updates
cursoragent Jul 29, 2026
ff293f6
docs: fix Requirements section anchor in Slack app FAQ
cursoragent Jul 29, 2026
320ebff
docs: document Slack attachment color API values for run notifications
cursoragent Jul 29, 2026
e27eb35
docs(slack): document ENG-179 automated reports to Slack
cursoragent Jul 29, 2026
f3aa91b
docs(automated-reports): document single Slack channel selection
cursoragent Aug 4, 2026
d193bfd
docs(automated-reports): describe Slack report message contents
cursoragent Aug 4, 2026
006e757
docs(ai): rephrase Fix with AI from Slack section
cursoragent Aug 4, 2026
902881f
docs(automated-reports): remove Slack delivery recommendation hint
cursoragent Aug 4, 2026
9e444d1
docs(slack): include timed-out state in attachment colors
cursoragent Aug 4, 2026
0b9f043
docs(slack-app): remove attachment color API implementation detail
cursoragent Aug 4, 2026
2a7e221
docs(slack-app): use user-friendly run attachment color labels
cursoragent Aug 4, 2026
f054f69
chore: update slack notification description
miguelangarano Aug 4, 2026
6a72a07
Merge branch 'main' into cursor/slack-docs-improvements-770b
miguelangarano Aug 4, 2026
b2f6d3c
chore: remove useless info
miguelangarano Aug 4, 2026
4a9a8ef
feat: docs updates
maxigimenez Aug 5, 2026
1b82b3c
feat: more tweaks.
maxigimenez Aug 5, 2026
de2a1e5
feat: more tweaks
maxigimenez Aug 5, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 5 additions & 6 deletions ai/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,6 +33,7 @@ Every entry point below delivers this same context - they differ in where you ar
| [MCP Server](mcp-server.md) | Any MCP-capable agent | Agents querying runs, tests, and analytics on demand; autonomous troubleshooting |
| [IDE Extension](ide-extension.md) | VS Code, Cursor, compatible forks | Debugging CI failures without leaving the editor |
| [Fix with AI](overview.md#fix-with-ai-from-the-dashboard) | Currents dashboard | Handing a failure to an agent while triaging a run |
| [Slack Fix with AI](../resources/integrations/slack/slack-app.md#fix-with-ai) | Slack | Handing a failed-test notification to an agent from a channel |
| [Playwright Skill](agent-skill-playwright-best-practices.md) | Claude Code, Cursor, other agents | Teaching agents how to write and fix Playwright tests correctly |
| [n8n](../resources/integrations/n8n.md) | n8n workflows | Automated triage, notifications, and agent pipelines without code |

Expand Down Expand Up @@ -84,6 +85,10 @@ You can copy the prompt to your clipboard for any agent, or open it directly in

This is the bridge from investigation to action: whoever is looking at the failing run - not necessarily the person with the repo open - can package the failure with its full context and route it to an agent in one click.

### Fix with AI from Slack

Failed-test notifications from the [Slack App](../resources/integrations/slack/slack-app.md#fix-with-ai) include a **Fix with AI** button. You can send the failed test context to Cursor, GitHub Copilot, Claude Code, Codex, Zed, Conductor, and other AI agents - routing a failure to an agent from a team channel without opening the Currents dashboard.

### Playwright Skill

Context tells an agent _what_ failed; the [Playwright Best Practices skill](agent-skill-playwright-best-practices.md) tells it _how_ to fix it well. It's an [Agent Skill](https://agentskills.io/home) - an open standard supported by Claude Code, Cursor, VS Code, and others - that packages expert Playwright knowledge: locator strategy, web-first assertions, debugging flaky tests, CI configuration, and more.
Expand All @@ -106,12 +111,6 @@ The [n8n integration](../resources/integrations/n8n.md) connects Currents to mor

Combined with [HTTP webhooks](../resources/integrations/http-webhooks.md) as a trigger, this covers the fully autonomous end of the spectrum - no editor, no dashboard, just test results flowing into whatever process you define.

## Coming up

### Slack

**Fix with AI** is coming to the [Slack integration](../resources/integrations/slack/): failed-test notifications will include a Fix with AI button that opens one-click deep links to AI coding tools, plus a copyable prompt for everything else - prefilled with the same enriched failure context and MCP identifiers as the dashboard and IDE actions. A failure lands in your team channel, and anyone in the thread can route it to an agent without opening the dashboard first.

## Combining entry points

These methods compose - most teams end up using several:
Expand Down
13 changes: 9 additions & 4 deletions dashboard/automated-reports.md
Original file line number Diff line number Diff line change
Expand Up @@ -68,13 +68,18 @@ Configure the settings and enable the automated report:

9. Use **Preview** to examine and change the report settings.

### Forward automated reports email to Slack
### Send automated reports to Slack

Slack currently allows receiving emails in a Slack channel or private message.
Projects with the [Slack App](../resources/integrations/slack/slack-app.md) connected at the organization level can deliver the same scheduled report to a Slack channel.

Slack generates an email where the automated reports will be sent and that must be registered in the dashboard. Slack then receives the email and forwards the email to the previously setup channel.
On the report customization page:
Comment thread
maxigimenez marked this conversation as resolved.

Check the [Slack documentation](https://slack.com/help/articles/206819278-Send-emails-to-Slack) for more information and detailed steps.
1. Enable the report and configure label, filters, lookback period, and schedule as for email.
Comment thread
maxigimenez marked this conversation as resolved.
2. In the **Slack** setting, enable **Send to Slack**.
3. Select the Slack channel that should receive the report.
4. Save the report. Email recipients and a Slack channel can be used together or independently.

At the scheduled time, Currents posts a summary to the selected channel. For details on the message format, prerequisites, channel selection, and troubleshooting, see [Automated Reports to Slack](../resources/integrations/slack/slack-app.md#automated-reports-to-slack).

### Report Structure

Expand Down
4 changes: 2 additions & 2 deletions guides/currents-actions/lifecycle-notifications.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ Enabling Slack notifications requires two steps:
1. **Connect Slack to the organization** following the [#installation](../../resources/integrations/slack/slack-app.md#installation "mention").

{% hint style="info" %}
Note that this OAuth flow requires an organization administrator.
A **Currents organization administrator** must connect, re-authenticate, or disconnect the integration. A **Slack administrator** must authorize the app; the exact required Slack role depends on whether the account uses a single workspace or Enterprise Grid.
{% endhint %}

<figure><img src="../../.gitbook/assets/image (48).png" alt=""><figcaption><p>Missing Slack App installation</p></figcaption></figure>
Expand All @@ -37,7 +37,7 @@ Connecting Slack under Integrations alone does not enable notifications — they

<figure><img src="../../.gitbook/assets/image (59).png" alt=""><figcaption><p>Slack channel configuration</p></figcaption></figure>

Once Slack is connected, anyone with **Actions Admin** access can configure the channel and events. If the Slack option is unavailable, an organization administrator must complete the Integrations setup first.
Once Slack is connected, anyone with **Actions Admin** access can configure the channel and events. If the Slack option is unavailable, a Currents organization administrator must complete the Integrations setup first.

#### Email

Expand Down
3 changes: 2 additions & 1 deletion resources/data-privacy/access-to-customer-data.md
Original file line number Diff line number Diff line change
Expand Up @@ -52,4 +52,5 @@ We collect diverse data from our users' test suites, which are strictly limited
* **GitHub**: No access to data or repos source code; we post comments and status check updates for Pull Requests. The integration application is listed here: [https://github.com/apps/currents-bot](https://github.com/apps/currents-bot), and the list of permissions appears as part of the setup.
* **GitLab**: We list repositories and projects, refresh oAuth tokens, post notes and status check updates to Merge Requests, fetching Merge Request details.
* **BitBucket**: No access to data; we only post status check updates for Pull Requests.
* **Microsoft Teams, Slack**: No access to data, just posting messages within the restrictions of the platform's rules.
* **Microsoft Teams**: No access to data; we only post messages within the restrictions of the platform's rules.
* **Slack**: No access to test data; we list channels, read workspace/user metadata, and post messages, limited by the OAuth permissions granted during installation.
19 changes: 13 additions & 6 deletions resources/integrations/slack/README.md
Original file line number Diff line number Diff line change
@@ -1,33 +1,40 @@
---
description: >-
Integrating Slack with Currents dashboard for Playwright and Cypress test
notifications
Integrating Slack with Currents dashboard for test notifications
icon: slack
---

# Slack

Currents integration with Slack allows posting test results of your Playwright or Cypress tests directly into Slack channels, helping your team stay informed about test outcomes without leaving Slack.
Currents integration with Slack allows posting test results directly into Slack channels, helping teams stay informed about test outcomes without leaving Slack.

There are two versions of Slack integration available:

{% hint style="info" %}
**Recommendation:** We recommend using the Slack App integration due to its advanced features and improved security model.
**Recommendation:** Currents recommends using the Slack App integration due to its advanced features and improved security model.
{% endhint %}

## [Slack App](slack-app.md) Integration (Recommended)

The Slack App integration provides a rich, feature-complete experience for test notifications:

* ✅ Organization-level installation with per-project configuration
* ✅ Multiple destinations (up to 10 channels per project)
* ✅ Multiple destinations (the dashboard shows the organization's limit; the default is 10)
* ✅ Run-level notifications with thread-based grouping
* ✅ Individual test failure notifications
* ✅ Individual failed or flaky test notifications
* ✅ Fix with AI from failed-test messages
* ✅ Run attachment colors for in-progress, timed-out, success, error, and cancelled states
* ✅ Live updates to the groups table on threaded run notifications
* ✅ Advanced filtering by tags, branches, and commit messages
* ✅ Annotation-based mentions (users, groups, emails)
* ✅ UI-based mention rules configuration
* ✅ Scheduled [Automated Reports](../../../dashboard/automated-reports.md) to a Slack channel (Block Kit summaries with dashboard links)
* ✅ Improved security with OAuth 2.0

The Slack App also delivers independently configured [Action lifecycle notifications](../../../guides/currents-actions/lifecycle-notifications.md) for actions that are created, disabled, re-enabled, archived, expiring, or expired. Connecting Slack under **Integrations** does not enable these notifications; Action notifications are configured under **Actions > Settings**.

Scheduled automated reports are configured per report on the project **Reports** page; see [Automated Reports to Slack](slack-app.md#automated-reports-to-slack).

## [Slack Webhook](slack-webhook.md) Integration (Legacy)

The webhook-based integration provides basic notification functionality:
Expand Down
Loading