Release Notes
Added
Introduce profiles for agent-centric configuration
Profiles are a new way to compose overlays together with AI harness capabilities — instruction files and plugins — into a single named, loadable unit. Where an overlay describes files to place in a repo, a profile describes intent: everything an agent needs for a given workflow. Apply a profile to an ephemeral GitHub Copilot or Claude Code session with repoverlay copilot --profile <name> or repoverlay claude --profile <name>, and the harness places each capability in the right location. Or apply one persistently with repoverlay profile apply <name> --harness <claude|copilot> and manage it with profile list/show/status/remove.
See the guide for details: https://repoverlay.tylerbutler.com/guides/profiles/
Apply multiple profiles in a single agent run
repoverlay copilot and repoverlay claude now accept --profile more than once, letting you stack several profiles into one ephemeral agent session. Each profile is applied and locked independently, and all of them are torn down automatically when the agent exits. If a profile fails to apply, any profiles already applied in that run are rolled back so the repository is left clean.
Global overlays that apply to any repository
Overlays placed in a source's reserved @global/ namespace now apply to every repository, regardless of its git remote. Create one with repoverlay create <name> --global, and apply it by its bare name (for example repoverlay apply dotfiles). Global overlays are listed for every repo under a Global heading in repoverlay browse and displayed as */<name>. Repo-scoped overlays still take precedence over a global overlay of the same name.
Install repoverlay 0.17.0
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/tylerbutler/repoverlay/releases/download/v0.17.0/repoverlay-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/tylerbutler/repoverlay/releases/download/v0.17.0/repoverlay-installer.ps1 | iex"Install prebuilt binaries via Homebrew
brew install tylerbutler/tap/repoverlayDownload repoverlay 0.17.0
| File | Platform | Checksum |
|---|---|---|
| repoverlay-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| repoverlay-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| repoverlay-x86_64-pc-windows-msvc.zip | x64 Windows | checksum |
| repoverlay-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| repoverlay-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |
Verifying GitHub Artifact Attestations
The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:
gh attestation verify <file-path of downloaded artifact> --repo tylerbutler/repoverlayYou can also download the attestation from GitHub and verify against that directly:
gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>