Show HN：使用 `rr` 將 AI 代理測試運行分散到您的閒置機器上

Navigation Menu

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

To see all available qualifiers, see our documentation.

Easily sync code to a remote machine and run commands there. That's it.

License

Uh oh!

There was an error while loading. Please reload this page.

rileyhilliard/rr

Folders and files

Latest commit

History

Repository files navigation

rr (Road Runner)

Run heavy workloads on remote machines without the hassle.

rr syncs your code to a remote machine and runs commands there. One command, no context switching.

Your project rsyncs to the remote, the command runs, and output streams back. Works from home, a coffee shop, or anywhere—rr figures out which connection works.

Contents

Why rr

I got tired of my laptop fan spinning up and battery draining every time I ran tests. I have a few beefy machines sitting in the corner doing nothing most of the time, so I wanted an easy way to sync code over and run heavy stuff on those instead.

Especially useful for agentic coding: If you're doing TDD with Claude Code, Cursor, or similar tools, AI agents want to run tests constantly to verify their work. With multiple sub-agents running in parallel—or multiple features being developed simultaneously—your test suite gets hammered from all directions. rr queues test runs across your machine pool so agents aren't all fighting over localhost (and failing tests because they're stomping on each other).

The problem with existing tools:

rr fills the gap: a single binary that handles sync, execution, locking, load balancing, and connection failover—nothing more.

Features

Quick start

That's the whole flow. rr syncs your code to the remote, runs the command, and streams output back.

Install

Homebrew (macOS/Linux)

Install script

Go install

Manual download

Grab the binary for your platform from releases.

Setup

Prerequisite: You need passwordless SSH access to your remote machine. If you can run ssh user@yourhost without entering a password, you're good. If not, see the SSH setup guide.

If rr init doesn't detect your SSH config, you can add hosts manually. See configuration docs.

Usage

You can also define named tasks in your config:

Then run them by name:

Parallel execution

Run multiple tasks across multiple hosts simultaneously. Define a parallel task that references other tasks, and rr distributes them across your machine pool with animated progress:

Tasks animate while running, then flip to success/failure in place:

Why this is powerful: A 10-minute test suite split across 4 hosts finishes in ~2.5 minutes. For agentic coding workflows where AI agents constantly run tests to verify their work, this means faster feedback loops and less waiting. Multiple agents or features being developed simultaneously get distributed across your machine pool automatically.

Output modes:

Configuration

rr uses two config files to separate personal settings from shareable project settings:

Global config — your machine definitions:

Project config — shareable settings:

${PROJECT} expands to your local directory name. See configuration docs for all options.

How It Works

Connection failover: rr tries each SSH path in order and uses the first one that connects. Configure your fastest option first:

File sync: Wraps rsync with smart defaults. Excludes build artifacts, preserves remote-only directories (like .venv installed on the remote).

Locking: Creates a lock before running commands. If a host is locked, rr tries the next host. If all hosts are locked, it round-robins until one frees up.

Output formatting: Auto-detects pytest, Jest, Go test, Cargo and formats failures for readability. Disable with --format=generic.

Commands

Troubleshooting

Start with rr doctor — it checks your config, SSH setup, and dependencies:

Common issues:

For more, see the troubleshooting guide.

Documentation

Claude Code Integration

If you use Claude Code, install the rr skill to let Claude help set up and manage your rr environment:

Once installed, Claude can help with setup and troubleshooting. To set up rr for your project. From your project root, run:

This walks through creating configs, verifying SSH connectivity, testing remote execution, and ensuring dependencies are available on your remote hosts.

See docs/claude-code.md for details.

Contributing

Contributions welcome! See CONTRIBUTING.md for development setup and guidelines.

License

MIT

About

Easily sync code to a remote machine and run commands there. That's it.

Resources

License

Code of conduct

Contributing

Security policy

Uh oh!

There was an error while loading. Please reload this page.

Stars

Watchers

Forks

Releases

  40

Packages

  0

Contributors

  3

Languages

Footer

Footer navigation