Skip to main content
On each pull request, TREX:
  1. Figures out which user flows your changes affect.
  2. Starts your app in a sandbox built from your environment.
  3. Uses the app like a user would: clicking, typing, and observing what’s on the screen.
  4. Posts what it tested and what broke, with a video of every flow.

​
Getting started

1

Turn on TREX for your organization

Open Settings → Agent Config → TREX → Settings and Enable TREX.
2

Set up an environment

Tell TREX how to set up and build all the dependencies that allow it to run your services. See Environments.
3

Open a pull request

TREX runs with the next review and posts a TREX comment.
You should configure an environment before using TREX.

​
Pricing

A TREX run costs 3 credits, on top of the code review. A run is charged only when at least one flow reaches a pass or fail. If TREX fails or returns nothing readable, it adds nothing. See Billing.

​
When TREX runs

Once Enable TREX is on, choose When TREX runs: A rule is a set of conditions such as branch, labels, authors, or file paths. All conditions in a rule must match. Rules inherited from a parent namespace show read-only under yours. Automatic TREX runs sets which pull request events start TREX, the same way it works for reviews. TREX also decides on its own when a pull request has nothing to test. For example, a change with no effect on how the app behaves. It skips testing, says why in its check, and doesn’t charge credits.

​
Run TREX on demand

You can also comment on a pull request to run TREX on it, even when Sometimes rules don’t match:

​
Opt out of your own pull requests

To opt out, open your account menu (top right) → Review → TREX Settings → TREX on my PRs and pick Off. Default follows the organization setting. Off also ignores on-demand requests on your pull requests.

​
Auto-approve

If you want TREX results to be included in Greptile’s auto-approval decision, turn on TREX auto-approve. You can do so in Settings → Agent Config → TREX → Settings, below When TREX runs.

​
Live progress

With Live progress on (the default), the TREX comment shows progress while TREX runs, then updates to the results when it finishes. Turn it off on the same settings page to post only the results.

​
Next

Environments

Build and start your app.

Custom flows

Pin the journeys TREX tests.

Results

Read the comment and watch the video.