Set up Patternis

Your review, your choice of where it runs.

Choose your setup

Use Codex or Claude on your computer
Review a selected pull request with your signed-in command-line tool. No API key; save the advisory locally. Preview · manual setup.

Automate reviews on GitHub
Install the GitHub App, add a workflow and supply your Anthropic API key. Reviews run in GitHub Actions; API usage is billed by your provider.

For hosted reviews, install Patternis on GitHub for the repositories you want to review. Already installed? Continue with the two repository steps below.

Check your repository

See whether Patternis has access, whether the runner workflow is registered, and what recent execution evidence shows.

Check setup with GitHub

Use your subscription · local preview

Already signed in to the native Codex or Claude CLI? This local tool can review one selected pull-request diff and save an advisory on your computer, without an API key. It does not connect your subscription to hosted Patternis.

Download the local review tools. Extract the ZIP, then open customer-tools/README.md for prerequisites and commands. You need Node 24 and the authenticated GitHub and provider CLIs; the README lists the supported CLI versions.

Preview limits: a local Codex run has been tested on one selected public pull request. Claude execution remains unverified here; review quality and repeatability across repositories are not established. These tools do not post reviews, edit code, open or merge PRs, or install runners. Remaining provider capacity is unknown. Provider limits and terms apply, and enabled extra usage or credits may incur charges. There is no automatic API fallback.

Hosted reviews · API setup

Patternis never receives your API key. It is stored as a secret in your repository and read only by a job running on your own Actions runner. Keep it in GitHub repository secrets, never in a pull request or chat. Your provider bills API usage separately, on your own rate limits.

1 · Add the workflow

Download the workflow and save it in your repository as .github/workflows/patternis-runner.yml, on your default branch.

The download is configured for this deployment. Commit the file at the path above so GitHub Actions can find it. Installing the App alone does not add this workflow to your repository.

It is deliberately readable end to end: it validates every dispatched input, refuses an unrecognised tier rather than defaulting, bounds the diff before it reaches a paid API, and never writes your key or your source to a log.

2 · Add your provider key

Settings → Secrets and variables → Actions → New repository secret

Name:   PATTERNIS_PROVIDER_KEY
Value:  sk-ant-…  (your own Anthropic API key)

v1 supports Anthropic keys only. A key of any other shape is refused rather than guessed at, because guessing would send your key and your source to the wrong vendor.

Then what

Open a pull request. Patternis routes the work by fitness and remaining headroom, runs it on your runner with your key, puts the review on that run's summary page, and posts a receipt on the pull request that links to it. A workflow in this repository can read its receipts: the tier chosen and every routing decision, bypass and refusal, including when Patternis declined to act.

If the tier a task needs has no room left, Patternis tries one tier up: a more capable model, which your provider may bill at a higher rate (reviews go from standard to deep, triage from instant to standard). If that tier has no room either, the task does not run.

Nothing on this page is personalised, and it reads nothing about your installation. It has nothing to leak.