// 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".
| 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". |
Offloads cargo build, bun test, gcc to remote workers. Transparent—same commands, faster builds.
1. 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.
which rustup rsync zstd (install missing)cargo install --path rch (or --path . from repo root)~/.config/rch/workers.toml (see below)rch hook installrchd & or systemctl --user start rchdrch doctor → all checks pass# ~/.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:
rch workers discover --from-ssh-config --dry-run # Preview
rch workers discover --from-ssh-config # Add to config
Verify workers:
rch workers probe worker1 --verbose # Test single
rch workers probe --all # Test all
rch workers list --capabilities # Show detected toolchains
| Symptom | Fix |
|---|---|
| SSH fails | eval $(ssh-agent) && ssh-add ~/.ssh/your_key |
| Daemon down | rm -f /tmp/rch.sock && rchd & |
| Hook missing | rch hook install --force |
| No workers | Check config path, SSH connectivity |
Test hook directly:
echo '{"tool":"Bash","input":{"command":"cargo check"}}' | rch hook
# Expect: {"allow":true,"output":"..."}
rch 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.
| Topic | Reference |
|---|---|
| Worker schema, selection algorithm, tags | WORKERS.md |
| All error messages & detailed fixes | TROUBLESHOOTING.md |
| Hook protocol, 5-tier classification | HOOKS.md |