Github File Track
Track files in GitHub repositories and materialize them on the local filesystem, deduplicated on the upstream Git blob SHA. One sync call fans out across any number of {repo, ref, srcPath, destPath} targets via the gh CLI, rewriting each destination only when the upstream content changed or the local file is missing. A composable primitive for keeping a local copy of a shared skill, snapshot, or config fresh.
Harden destination writes following PR #1: reject normalized destination and sync-record slug collisions before fan-out, atomically replace changed files, and clean up temporary files after failed replacement.
Global Arguments
| Argument | Type | Description |
|---|---|---|
| targets | array |
| Argument | Type | Description |
|---|---|---|
| targets? | array |
Resources
Fail sync runs when any GitHub target cannot be fetched, persist structured failure summaries, and add execution-level regression coverage. Fix contributed by @sntxrr in meagerfindings/swamp-github-file-track#1.
Rebuild against swamp CLI 20260716
- Has README or module doc2/2earned
- README has a code example1/1earned
- README is substantive1/1earned
- Most symbols documented1/1earned
- No slow types (deprecated)1/1earned
- Dependencies pass trust audit2/2earned
- Has description1/1earned
- Platform support declared (or universal)2/2earned
- License declared1/1earned
- Verified public repository2/2earned