remote-bash

Execute bash commands against any public GitHub repository without cloning it to the local machine.

npx remote-bash <target> [options] -- <command>

Target formats

Format	Example	Behavior
`owner/repo`	`vercel/next.js`	Target the default branch
`package-name`	`zod`	Reads version from local lockfile, resolves to repo + exact SHA

Options

Option	Description
`-ref <branch\|commit>`	Target a specific branch or commit SHA
`-v <version>`	Target a specific version/tag

Examples

# check how next.js exports its cache APIs
npx remote-bash vercel/next.js -- cat packages/next/cache.d.ts

# find all ZodIssueCode types in zod (uses your lockfile version)
npx remote-bash zod -- grep "ZodIssueCode" packages/zod/src/v3/ZodError.ts

# explore three.js module structure
npx remote-bash mrdoob/three.js -- ls src/

# search for cacheLife usage across next.js canary branch
npx remote-bash vercel/next.js -ref canary -- grep -rn "cacheLife" --include="*.ts"

# check a specific three.js release
npx remote-bash mrdoob/three.js -v r150 -- cat src/Three.js

Key Benefits

No local clone: Runs in the cloud, nothing downloaded to your machine
Lockfile-aware: Package names resolve to the exact version you have installed
Version pinning: Explore different branches, commits, or tags with -ref and -v