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