One binary.
macOS (Apple Silicon and Intel) and Linux. Optional but recommended for offline mode: brew install act.
No Homebrew? Go works too. Windows is not supported yet.
Docs.
Everything in one page: install, the human path, the agent path, and the reference.
01 / Install
02 / Humans
The four-command path.
Authenticate (device flow or --pat), create host-sized defaults, install the login daemon. For GitHub Enterprise: homeplate auth add work --host git.example.com.
Discover GitHub clones on this machine. Add --link to register them and --adopt to open the routing PRs, all in one pass.
Open one PR per linked repo rewriting runs-on: to Homeplate labels. --variable uses a repo variable instead, so repos flip between hosted and local from settings, no commits. Merge the PRs once; done forever.
Queue, caps, power state, and net dollars saved. --explain-savings shows the full audit trail.
03 / Agents
Hand it to an agent.
Homeplate is built to be operated by an AI assistant: homeplate auto is fully non-interactive, idempotent, and emits JSON. Paste this into your agent of choice:
Agents should read llms.txt (machine-readable summary) or the repo’s AGENTS.md (operational runbook: env vars, exit behavior, safety flags).
- Non-interactive
autonever prompts. Missing auth → it exits with the exact remediation (HOMEPLATE_GITHUB_TOKENorhomeplate auth add).- Idempotent
- Safe to re-run: link and adopt dedupe, service install is repeatable, mirrors refresh in place.
- Machine-readable
--jsononauto,scan, andstatus. Global--profileselects the identity.- Safe defaults
- Public repos require
--i-understand-public-repo-risk. Private repos only, unless a human says otherwise.
04 / Reference
Commands.
| Command | What it does |
|---|---|
homeplate auto | One-shot setup: auth → scan → link → adopt → daemon. --dry-run, --json |
homeplate scan | Find GitHub clones on disk. --link, --adopt, --json |
homeplate init | Interactive setup: auth, defaults, daemon |
homeplate auth add/list/remove | Named identities, OS keychain storage, GHES via --host |
homeplate link | Pick repos/orgs to serve. --all, --orgs |
homeplate adopt | PR rewriting runs-on:. --all, --variable, --dry-run |
homeplate status | Queue, caps, power, engine, net $ saved. --explain-savings, --json |
homeplate limit | Hot-reloaded caps: --cpus, --memory, --concurrency, --only-when-idle, --clamshell |
homeplate run | Run a workflow locally right now (offline engine) |
homeplate logs | Recent jobs, one job’s log, --follow the daemon |
homeplate pause / resume | Stop/start job pickup |
homeplate power setup | One-time sudo helper for the lid-close toggle. --revert removes it |
homeplate doctor | Diagnose Docker, power, routing, connectivity, drift |
homeplate service | Install/remove/status of the login daemon |
Config lives at ~/.homeplate/config.toml (hot-reloaded), rates at ~/.homeplate/rates.json, tokens in the OS keychain. Full details in the repo README.