Source: https://internal-agents.com/agents/shopify-river

# Shopify — River

River is Shopify’s internal Slack agent for investigating questions and making code changes in public threads.

- Company: [Shopify](https://internal-agents.com/organizations/shopify)
- Collection: Agents
- Approach type: Agent
- Deployment stage: Deployed
- Autonomy: Unknown
- Evidence strength: Detailed primary
- Status: Internal
- First reported year: 2026
- Work: Coding
- Interfaces: Slack
- Invocation: Interactive
- Entry reviewed: 2026-09-17

## Purpose

### Summary

River is Shopify’s internal Slack agent for investigating questions and making code changes in public threads.

Fact · Reported · High confidence · `shopify-river--summary`

Confidence reason: A linked first-party source states the claim.

Evidence:

- Supports · [1] [Under the River](https://shopify.engineering/under-the-river) · Part II: River only works in the open; At scale; River is one profile

Representative workflow: public Slack question → collaborative investigation or code change.

## How it works

### Receive a request

An employee mentions River in a public Slack channel.

Fact · Reported · High confidence · `shopify-river--primitives-0`

Confidence reason: A linked first-party source states the claim.

Evidence:

- Supports · [1] [Under the River](https://shopify.engineering/under-the-river) · Part II: River only works in the open; At scale; River is one profile

### Investigate and act

River reads files, runs tests and queries, and posts findings; it can open pull requests.

Fact · Reported · High confidence · `shopify-river--primitives-1`

Confidence reason: A linked first-party source states the claim.

Evidence:

- Supports · [1] [Under the River](https://shopify.engineering/under-the-river) · Part II: River only works in the open; At scale; River is one profile

### Continue collaboratively

Colleagues add constraints and redirect the work within the same thread.

Fact · Reported · High confidence · `shopify-river--primitives-2`

Confidence reason: A linked first-party source states the claim.

Evidence:

- Supports · [1] [Under the River](https://shopify.engineering/under-the-river) · Part II: River only works in the open; At scale; River is one profile

## Where people stay involved

- **public Slack question → collaborative investigation or code change** — Unknown · Level unknown

**Unreported:** The source describes a colleague optionally redirecting a public thread, but does not require continuous steering or a universal PR approval checkpoint.

### Supervision evidence

#### Operating model assessment

Unclassified for public Slack question → collaborative investigation or code change; human attention boundary: unknown.

Inference · Catalog judgment · Unverified confidence · `shopify-river--operating-models-0`

Confidence reason: The source describes a colleague optionally redirecting a public thread, but does not require continuous steering or a universal PR approval checkpoint.

Qualifications:

- Observation date: 2026

Evidence:

- Supports · [1] [Under the River](https://shopify.engineering/under-the-river) · River only works in the open: well-going thread includes a colleague redirect and continued collaboration

## Implementation details

### Harness

An agent profile on Aquifer.

Fact · Reported · High confidence · `shopify-river--architecture-harness`

Confidence reason: A linked first-party source states the claim.

Evidence:

- Supports · [1] [Under the River](https://shopify.engineering/under-the-river) · Part II: River only works in the open; At scale; River is one profile

### Tool access

Code, tests, data warehouse and production traces.

Fact · Reported · High confidence · `shopify-river--architecture-tool-access`

Confidence reason: A linked first-party source states the claim.

Evidence:

- Supports · [1] [Under the River](https://shopify.engineering/under-the-river) · Part II: River only works in the open; At scale; River is one profile

### Knowledge

World monorepo, skills and shared Slack transcripts.

Fact · Reported · High confidence · `shopify-river--architecture-knowledge`

Confidence reason: A linked first-party source states the claim.

Evidence:

- Supports · [1] [Under the River](https://shopify.engineering/under-the-river) · Part II: River only works in the open; At scale; River is one profile

### Interfaces

slack

Fact · Reported · High confidence · `shopify-river--architecture-interfaces`

Confidence reason: A linked first-party source states the claim.

Evidence:

- Supports · [1] [Under the River](https://shopify.engineering/under-the-river) · Part II: River only works in the open; At scale; River is one profile

### Implementation coverage

- **Model:** unreported — Not documented for this subject in the reviewed source.
- **Harness:** reported
- **Sandbox:** unreported — Not documented for this subject in the reviewed source.
- **Tool access:** reported
- **Knowledge:** reported
- **Context management:** unreported — Not documented for this subject in the reviewed source.
- **Credentials:** unreported — Not documented for this subject in the reviewed source.
- **Interfaces:** reported

**Unreported:** The reviewed source does not report a distinct validation process for this subject.

## Reported observations

Observation: Adoption output · Reported measurement · River: 59,918 sessions across 5,170 Slack channels in a reported 30-day period; 3,536 River-coauthored PRs merged.

### Key observation

59,918 sessions across 5,170 Slack channels in a reported 30-day period; 3,536 River-coauthored PRs merged.

Metric · Reported · Medium confidence · `shopify-river--key-metrics-0`

Confidence reason: Self-reported by the source; no independent verification.

Qualifications:

- The source does not report the denominator of this figure.
- Reported by: Shopify
- Scope: River: 59,918 sessions across 5,170 Slack channels in a reported 30-day period; 3,536 River-coauthored PRs merged.
- Method: river_sessions domain table written by River each session

Evidence:

- Supports · [1] [Under the River](https://shopify.engineering/under-the-river) · At scale: recent 30-day river_sessions domain-table counts

## Lessons

**Unreported:** The reviewed source does not document this for the named subject.

## Question coverage and scope

- **purpose:** Reported
- **workflow:** Reported
- **human involvement:** Unreported — The source describes a colleague optionally redirecting a public thread, but does not require continuous steering or a universal PR approval checkpoint.
- **implementation:** Reported
- **validation:** Unreported — The reviewed source does not report a distinct validation process for this subject.
- **observations:** Reported
- **lessons:** Unreported — The reviewed source does not document this for the named subject.

## Related reading

- Built on: [Shopify — Aquifer](https://internal-agents.com/agents/shopify-internal-agents)

## Sources

1. [Under the River](https://shopify.engineering/under-the-river)
   - Engineering blog · First party · Evidence
   - Original URL: <https://shopify.engineering/under-the-river>
   - Accessed: 2026-08-12 · Last verified: 2026-08-31
