Skip to main content

Github File Track

@mgreten/github-file-trackv2026.08.02.2· 20d agoMODELS
01README

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.

02Release Notes

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.

03Models1
@mgreten/github-file-trackv2026.08.02.2github_file_track.ts

Global Arguments

ArgumentTypeDescription
targetsarray
fn sync(targets?: array)
Fetch each tracked file from GitHub and write it locally when the
ArgumentTypeDescription
targets?array

Resources

syncRecord(infinite)— Per-destination record of the last sync: upstream blob SHA, whether
syncSummary(infinite)— Aggregate counts across all targets in one sync run.
04Previous Versions4
2026.08.02.1

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.

2026.07.16.1

Rebuild against swamp CLI 20260716

2026.06.27.1
2026.05.29.1
05Stats
A
100 / 100
Downloads
22
Archive size
14.2 KB
  • 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
06Platforms