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
