Skip to content
Documentation

Docs / Adapter commands / Turborepo

Turborepo adapter

Keep Turbo's task hashes, graph, and outputs. The adapter supplies the remote-cache endpoint and short-lived process credential.

Command
boringcache turbo
Protocol
Turborepo Remote Cache API over /v8/artifacts/*
Action
mode: turbo

How the adapter works

Turbo-native artifacts

Turborepo still hashes task inputs and stores task artifacts through its remote-cache API.

Works outside one provider

Use the same cache from GitHub Actions, another CI runner, or a local shell.

One trust model

Restore from pull requests. Save from trusted jobs.

Set up Turborepo

Keep the command and cache tag in .boringcache.toml, then use the same boringcache turbo entrypoint locally and in CI.

[adapters.turbo]
tag = "turbo-cache"
command = ["turbo", "run", "build"]

# Run: boringcache turbo

Before the first run

  • Install the repository's Node package manager and Turbo version.
  • Keep task inputs and outputs declared in the Turborepo configuration.
  • Use stable metadata hints; task hashes already identify individual artifacts inside the adapter tag.

Use the same adapter in GitHub Actions

The Action starts the Turbo adapter and gives the later Turbo command its remote-cache environment.

.github/workflows/ci.yml 
- uses: boringcache/one@f0fb9b2d926a32b10c543e92093ba00c5a291b79 # v1.33.0
  with:
    trust-policy: auto
    mode: turbo

- run: pnpm turbo run build

Approve the repository through Connect CI and grant the job contents: read and id-token: write. The Action uses that Machine connection. Pull requests restore by default; trusted jobs may publish. See the authentication example in the GitHub Actions reference for scoped credentials when OIDC is unavailable.

GitHub Actions reference

Benchmarks

n8n · Turbo remote cache.

70–94%

Less cache to store

BoringCache stored 70–94% less cache data across public Go, Gradle, Maven, Nx, Turbo, and sccache comparisons.

Open run →
Turborepo cache page All benchmarks

Tool reference

Check the tool's own reference when you need cache-key rules, build settings, or version-specific behavior.

All adapter commands

Compare every supported command, protocol, and Action mode in one place.

Adapter command index →

Need help or found something unclear? Open an issue or browse the CLI repo.