How tylerbutler/repoverlay works
repoverlay is a Rust CLI for defining reusable overlays and applying their files to a Git repository without committing them. The primary workflow is to discover or select an overlay, resolve its local or remote source, apply files into the working tree, and track state while excluding applied files from Git. Separate capabilities manage sources, caches, the in-repository library, and experimental profiles with harness instructions and plugins. Relationships among unsampled command implementations are limited to documented workflows and SOURCE INDEX references.
Main entry points: resolve.rs Source resolution · mod.rs Command dispatch · profile_plan.rs Profile planning · browse.rs Browse overlays
Components 28
CLI and selection
- Command dispatch
src/cli/mod.rs - Browse overlays
src/cli/commands/browse.rs - Interactive selection
src/selection.rs
Overlay lifecycle
- Create overlays
src/cli/commands/create.rs - Edit overlays
src/cli/commands/edit.rs - Sync overlays
src/cli/commands/sync.rs - Apply and manage
src/cli/mod.rs - File detection
src/detection.rs - Git exclusions
src/git_exclude.rs - Overlay status
src/status.rs - Restore overlays
src/restore.rs - Overlay state
src/state.rs
Sources and storage
- Source resolution
src/resolve.rs - Overlay references
src/reference.rs - Source registry
src/sources.rs - Repository cache
src/cache.rs - GitHub parsing
src/github.rs - Upstream updates
src/upstream.rs - Shared overlay repo
src/overlay_repo.rs - In-repo library
src/library.rs
Profiles and harnesses
- Configuration
src/config.rs - Profile definitions
src/profile.rs - Profile planning
src/profile_plan.rs - Plugin resolution
src/plugin.rs - Harness applicators
src/profile_applicators/mod.rs - Claude integration
src/profile_applicators/claude.rs - Copilot integration
src/profile_applicators/copilot.rs
Other components
- CLI user
Connections 35
- CLI user → Command dispatch: runs commands
README.md - Command dispatch → Browse overlays: dispatches to
- Command dispatch → Create overlays: dispatches to
src/cli/mod.rs - Command dispatch → Edit overlays: dispatches to
src/cli/mod.rs - Command dispatch → Sync overlays: dispatches to
src/cli/mod.rs - Browse overlays → Interactive selection: uses
src/cli/commands/browse.rs - Browse overlays → Source resolution: resolves sources
src/cli/commands/browse.rs - Browse overlays → Apply and manage: applies selection
README.md - Create overlays → Interactive selection: uses
src/cli/commands/create.rs - Edit overlays → File detection: uses
src/cli/commands/edit.rs - Edit overlays → Interactive selection: uses
src/cli/commands/edit.rs - Sync overlays → Interactive selection: uses
src/cli/commands/sync.rs - Sync overlays → Create overlays: reuses logic
src/cli/commands/sync.rs - Apply and manage → Overlay state: persists state
src/cli/mod.rs - Apply and manage → Git exclusions: excludes files
README.md - Apply and manage → Repository cache: caches remote source
README.md - Overlay status → Overlay state: reads state
- Restore overlays → Overlay state: restores from state
- Source resolution → GitHub parsing: parses GitHub sources
src/resolve.rs - Source resolution → Source registry: uses registry
src/resolve.rs - Source resolution → Repository cache: uses cached repos
src/resolve.rs - Source resolution → Overlay references: parses references
src/resolve.rs - Source resolution → Shared overlay repo: uses overlay repo
src/resolve.rs - Source resolution → In-repo library: uses library
src/resolve.rs - Source registry → Repository cache: manages cached sources
src/sources.rs - Upstream updates → GitHub parsing: uses GitHub data
src/upstream.rs - Command dispatch → Configuration: loads configuration
src/cli/mod.rs - Configuration → Profile definitions: defines profiles
src/config.rs - Profile planning → Profile definitions: plans profiles
src/profile_plan.rs - Profile planning → Plugin resolution: resolves plugins
src/profile_plan.rs - Profile planning → Harness applicators: delegates application
src/profile_plan.rs - Harness applicators → Claude integration: dispatches harness
src/profile_applicators/mod.rs - Harness applicators → Copilot integration: dispatches harness
src/profile_applicators/mod.rs - Profile planning → Overlay state: uses repo state
src/profile_plan.rs - Plugin resolution → Repository cache: resolves remote assets
src/plugin.rs