Read files from any public GitHub repo at /mnt/github/<owner>/<repo>/. Use for: debugging library source code, fetching documentation from repos, exploring implementations, finding API signatures/types, diagnosing upstream bugs, downloading files from github. Trigger on: 'how does X work', 'read the source of', researching libraries, referencing external code. Much more useful than you think.
Lazily read any public repo at /mnt/github/<owner>/<repo>/. It's a FUSE filesystem that caches and lazily downloads GitHub repos to your machine. This means that you can use normal unix commands (e.g. rg, find, grep, cat), and normal tools to read files.
# Read any file
cat /mnt/github/tokio-rs/tokio/src/runtime/mod.rs
# Search across a repo
rg "async fn spawn" /mnt/github/tokio-rs/tokio/
# Explore structure
ls /mnt/github/vercel/next.js/packages/
# download a skill file
cat /mnt/github/rgodha24/ghfs/skills/ghfs/SKILL.md
keep in mind:
it's readonly. no writes/commits/etc.
it is a checked out worktree, often of a --depth=1 clone. this means that git log will not work as you expect in most cases.
explore subagent to look at multiple different libraries, and find API signatures, docs, etc. if you run into edge cases.| Command | Purpose |
|---|---|
ghfs list | Shows downloaded repos |
ghfs sync owner/repo | Force refresh of a repo |
ghfs watch owner/repo | refresh every 1h |