{"_id":"@amxv/pluck","_rev":"2-d7f1aa56de69102c3563405f839243eb","name":"@amxv/pluck","dist-tags":{"latest":"0.2.0"},"versions":{"0.1.0":{"name":"@amxv/pluck","version":"0.1.0","keywords":["github","folder","download","go","cli"],"author":{"name":"amxv"},"license":"Apache-2.0","_id":"@amxv/pluck@0.1.0","maintainers":[{"name":"amxv","email":"a@ashray.xyz"}],"homepage":"https://pluck-delta.vercel.app","bugs":{"url":"https://github.com/amxv/pluck/issues"},"bin":{"pluck":"bin/pluck.js"},"dist":{"shasum":"0f9828160f497467a7ea3e07418ee27fd3a2bbf5","tarball":"https://registry.npmjs.org/@amxv/pluck/-/pluck-0.1.0.tgz","fileCount":15,"integrity":"sha512-p3t2gKekLpxbFPkE3OTULWvhKTT4IJvEKbUOjMJvpD8jLWMdCbWMUy8h81JnnMyudDzKkUWdZ01EPlo/7wAmwg==","signatures":[{"sig":"MEYCIQCn/zaadgF5UwwCaB1Y1+Nddy6/Yfq44ldHMaUPmh6v/QIhAJ6ndfcXqQByQ5Li5Rah19k4ycGPTLO/JdP0pDaQuzAM","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":48041},"config":{"cliBinaryName":"pluck"},"engines":{"node":">=18"},"gitHead":"e6380b32bde23445d073d1e81b2ff79d35349d76","scripts":{"lint":"npm run test","test":"node --check bin/pluck.js && node --check scripts/postinstall.js","docs:dev":"astro dev","docs:build":"astro build","docs:check":"astro check","postinstall":"node scripts/postinstall.js","docs:preview":"astro preview"},"_npmUser":{"name":"amxv","email":"a@ashray.xyz"},"repository":{"url":"git+https://github.com/amxv/pluck.git","type":"git"},"_npmVersion":"10.9.8","description":"Copy folders from GitHub repository URLs into a local directory","directories":{},"_nodeVersion":"22.23.1","_hasShrinkwrap":false,"devDependencies":{"astro":"^7.0.3","zuedocs":"0.1.25","typescript":"^5.9.2","@types/node":"^24.0.13","@astrojs/check":"^0.9.4"},"_npmOperationalInternal":{"tmp":"tmp/pluck_0.1.0_1785743847873_0.359911300125092","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@amxv/pluck","version":"0.2.0","description":"Copy folders or files from GitHub repository URLs into a local directory","license":"Apache-2.0","author":{"name":"amxv"},"repository":{"type":"git","url":"git+https://github.com/amxv/pluck.git"},"homepage":"https://pluck-delta.vercel.app","bugs":{"url":"https://github.com/amxv/pluck/issues"},"bin":{"pluck":"bin/pluck.js"},"config":{"cliBinaryName":"pluck"},"scripts":{"postinstall":"node scripts/postinstall.js","test":"node --check bin/pluck.js && node --check scripts/postinstall.js","lint":"npm run test","docs:dev":"astro dev","docs:build":"astro build","docs:preview":"astro preview","docs:check":"astro check"},"engines":{"node":">=18"},"keywords":["github","folder","download","go","cli"],"devDependencies":{"@astrojs/check":"^0.9.4","@types/node":"^24.0.13","astro":"^7.0.3","typescript":"^5.9.2","zuedocs":"0.1.25"},"_id":"@amxv/pluck@0.2.0","gitHead":"c85765929b36abbf95c9d05c4b69433c887a5de6","_nodeVersion":"22.23.1","_npmVersion":"10.9.8","dist":{"integrity":"sha512-Tlxq/Z9JMMGIbeQ/UVSUHtIu7jM4XBKkw6Q+ha04DR6B6cEHCJ6QiKyZAGN4iLkcpBF8hr0a1RbxE4SoCochMQ==","shasum":"4e021f08af6d8b7adeaba324bda59c4cddfc96b5","tarball":"https://registry.npmjs.org/@amxv/pluck/-/pluck-0.2.0.tgz","fileCount":15,"unpackedSize":54838,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDNTC+dJ7hUpOhnAvJKvDgBZbrLXhf/hJXvvoqIJdcPZQIgAn7dNgkNvZzvAtW2eKdd1mRoUeSibg7tayLNnZnh7lc="}]},"_npmUser":{"name":"amxv","email":"a@ashray.xyz"},"directories":{},"maintainers":[{"name":"amxv","email":"a@ashray.xyz"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/pluck_0.2.0_1785748809320_0.48302619731992236"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-03T07:57:27.664Z","modified":"2026-08-03T09:20:09.626Z","0.1.0":"2026-08-03T07:57:27.996Z","0.2.0":"2026-08-03T09:20:09.467Z"},"bugs":{"url":"https://github.com/amxv/pluck/issues"},"author":{"name":"amxv"},"license":"Apache-2.0","homepage":"https://pluck-delta.vercel.app","keywords":["github","folder","download","go","cli"],"repository":{"type":"git","url":"git+https://github.com/amxv/pluck.git"},"description":"Copy folders or files from GitHub repository URLs into a local directory","maintainers":[{"name":"amxv","email":"a@ashray.xyz"}],"readme":"# pluck\n\nCopy a folder or file from a GitHub repository into a local directory.\n\nRead the guides at [pluck-delta.vercel.app](https://pluck-delta.vercel.app).\n\n`pluck` accepts GitHub tree and blob URLs, downloads the requested source through\nthe GitHub API, and writes it to `/tmp` by default. Private repositories work through\n`GH_TOKEN`, `GITHUB_TOKEN`, or the active `gh` account.\n\n## Install\n\n```bash\nnpm install --global @amxv/pluck\n```\n\nOr build from source:\n\n```bash\nmake build\n./dist/pluck --help\n```\n\n## Usage\n\n```bash\npluck https://github.com/vercel-labs/agent-skills/tree/main/skills/composition-patterns\n```\n\nThe example above creates `/tmp/composition-patterns`.\n\nPass a GitHub blob URL to copy one file. The file name is appended to the output\ndirectory:\n\n```bash\npluck https://github.com/amxv/go-cli-template/blob/main/internal/app/app.go\n# writes /tmp/app.go\n```\n\nUse `--output` or `-o` to choose the destination directory. The source name is\nappended to that path:\n\n```bash\npluck -o ./skills https://github.com/vercel-labs/agent-skills/tree/main/skills/composition-patterns\n# writes ./skills/composition-patterns\n```\n\nMultiple URLs can be copied in one invocation:\n\n```bash\npluck -o /tmp URL1 URL2\n```\n\nUse `--force` or `-f` to replace an existing extracted folder. Run\n`pluck --help` for the complete command reference.\n\n## Authentication\n\nPublic repositories work without a token. For private repositories, set one\nof these environment variables:\n\n```bash\nexport GH_TOKEN=github_pat_...\npluck https://github.com/your-org/your-repo/tree/main/path/to/folder\n```\n\nWhen no token variable is set, `pluck` tries `gh auth token` and uses the\nactive GitHub CLI account.\n\n## Development\n\n```bash\nbun install\nmake check\nmake build\nbun run docs:check\nbun run docs:build\n```\n\nThe Go command lives under `cmd/pluck`, with download logic in\n`internal/github`. The Astro/ZueDocs site documents the CLI and builds to\n`dist` for Vercel.\n\n## Releases\n\nPush a `v*` tag to build native binaries, create a GitHub release, and publish\nthe npm wrapper package:\n\n```bash\nmake release-tag VERSION=0.1.0\n```\n\nThe release workflow expects the repository's `NPM_TOKEN` secret for npm\npublishing.\n\n## License\n\nApache License 2.0. See [LICENSE](./LICENSE).\n","readmeFilename":"README.md"}