---

name: remote-compilation-helper-setup description: >- Configure RCH workers, install hooks, fix SSH/daemon issues. Use when setting up remote compilation, adding build machines, troubleshooting rch doctor, or "no workers available".

RCH Setup

Offloads cargo build, bun test, gcc to remote workers. Transparent—same commands, faster builds.

Workflow

Copy1. rch doctor           # What's broken?
2. rch doctor --fix     # Auto-fix common issues
3. rch doctor           # All green? Done.

If --fix can't solve it, continue below.

Setup Checklist

• Prerequisites: which rustup rsync zstd (install missing)
• Install: cargo install --path rch (or --path . from repo root)
• Configure: Create ~/.config/rch/workers.toml (see below)
• Hook: rch hook install
• Daemon: rchd & or systemctl --user start rchd
• Validate: rch doctor → all checks pass

Worker Config

Copy# ~/.config/rch/workers.toml
[[workers]]
id = "worker1"
host = "192.168.1.100"
user = "ubuntu"
identity_file = "~/.ssh/id_ed25519"
total_slots = 8    # ≈ CPU cores - 2
priority = 100     # Higher = preferred
tags = ["rust"]    # Optional capability tags

Discover from SSH config:

Copyrch workers discover --from-ssh-config --dry-run  # Preview
rch workers discover --from-ssh-config            # Add to config

Verify workers:

Copyrch workers probe worker1 --verbose  # Test single
rch workers probe --all              # Test all
rch workers list --capabilities      # Show detected toolchains

Quick Fixes

Test hook directly:

Copyecho '{"tool":"Bash","input":{"command":"cargo check"}}' | rch hook
# Expect: {"allow":true,"output":"..."}

Validation

Copyrch doctor --verbose   # Full diagnostics
rch doctor --json      # Machine-readable
RCH_DRY_RUN=1 cargo check  # Test without remote execution

⚠️ All rch doctor checks must pass before use.

References