{"id":15684377,"url":"https://github.com/geopjr/pog","last_synced_at":"2025-06-10T09:33:40.985Z","repository":{"id":103304041,"uuid":"476024004","full_name":"GeopJr/pog","owner":"GeopJr","description":"A faster npm run \u0026 npx","archived":false,"fork":false,"pushed_at":"2022-04-27T19:30:22.000Z","size":36,"stargazers_count":11,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-06-03T13:18:43.999Z","etag":null,"topics":["crystal","npm","npx","pnpm","yarn"],"latest_commit_sha":null,"homepage":"","language":"Crystal","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-2-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/GeopJr.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"GeopJr","custom":["https://www.paypal.me/GeopJr","https://geopjr.dev/donate"]}},"created_at":"2022-03-30T19:30:19.000Z","updated_at":"2024-12-27T19:10:56.000Z","dependencies_parsed_at":null,"dependency_job_id":"870e4ad9-ffac-40a0-b515-e8fd361a8360","html_url":"https://github.com/GeopJr/pog","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GeopJr%2Fpog","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GeopJr%2Fpog/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GeopJr%2Fpog/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GeopJr%2Fpog/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GeopJr","download_url":"https://codeload.github.com/GeopJr/pog/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GeopJr%2Fpog/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":258962368,"owners_count":22784828,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["crystal","npm","npx","pnpm","yarn"],"created_at":"2024-10-03T17:15:44.704Z","updated_at":"2025-06-10T09:33:40.938Z","avatar_url":"https://github.com/GeopJr.png","language":"Crystal","funding_links":["https://github.com/sponsors/GeopJr","https://www.paypal.me/GeopJr","https://geopjr.dev/donate"],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n\u003c!-- I probably spent more time redrawing \u0026 optimizing this crewmate... --\u003e\n\u003c!-- But hey! They're cute! --\u003e\n  \u003cimg width=\"200\" alt=\"Among Us crewmate\" src=\"./logo.svg\"\u003e\n\u003c/p\u003e\n\u003ch1 align=\"center\"\u003e🍋 pog 🍋\u003c/h1\u003e\n\u003ch4 align=\"center\"\u003eA faster \u003ccode\u003enpm run\u003c/code\u003e \u0026 \u003ccode\u003enpx\u003c/code\u003e\u003c/h4\u003e\n\u003cp align=\"center\"\u003e\n  \u003cbr /\u003e\n    \u003ca href=\"https://github.com/GeopJr/pog/blob/main/CODE_OF_CONDUCT.md\"\u003e\u003cimg src=\"https://img.shields.io/badge/Contributor%20Covenant-v2.1-409f00.svg?style=for-the-badge\u0026labelColor=f6f657\" alt=\"Code Of Conduct\" /\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/GeopJr/pog/blob/main/LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/badge/LICENSE-BSD--2--Clause-409f00.svg?style=for-the-badge\u0026labelColor=f6f657\" alt=\"BSD-2-Clause\" /\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/GeopJr/pog/actions\"\u003e\u003cimg src=\"https://img.shields.io/github/workflow/status/geopjr/pog/Specs%20\u0026%20Lint/main?labelColor=f6f657\u0026style=for-the-badge\" alt=\"ci action status\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n#\n\n## What is pog?\n\nIt's an extremely fast \u0026 dependency-less replacement for `npm run` and `npx`.\n\nPog is inspired by [@egoist](https://github.com/egoist/)'s [dum](https://github.com/egoist/dum/), but written in Crystal instead of Rust.\n\n\u003e It was really fun trying to optimize it as much as possible!\n\nThey are mostly on par in terms of speed and functionality. Pog however is missing the \"interactive\" mode as I'd rather keep it dependency-less.\n\n#\n\n## Installation\n\n### Pre-built\n\nYou can download one of the pre-built binaries from the [releases page](https://github.com/GeopJr/pog/releases/latest) for Linux \u0026 MacOS.\n\nFor Linux, there's a static build available (and is recommended).\n\nThey are built \u0026 published by our lovely [actions](https://github.com/GeopJr/pog/actions/workflows/release.yml).\n\n### Building\n\n#### Dependencies\n\n- `crystal` - `1.3.2`\n\n#### Makefile\n\n- `$ make` (or `$ make static` on Alpine Linux for a static build)\n- `# make install`\n\n##### Enable Deep-Search\n\nIf you build with the `POG_ENABLE_DEEPSEARCH=true` env var, you'll enable deep-search.\n\nInstead of looking for binaries in `node_modules/.bin` it will look through all folders/dependencies.\n\n#\n\n## Benchmarks\n\n`$ hyperfine \"./pog-static foo\" \"./pog foo\" \"./dum foo\" \"npm run foo\" --warmup 10`\n\n|     Command      |  Mean [ms]   | Min [ms] | Max [ms] |  Relative   |\n| :--------------: | :----------: | :------: | :------: | :---------: |\n| `pog-static foo` |  51.4 ± 8.4  |   38.4   |   69.9   |    1.00     |\n|    `dum foo`     |  51.9 ± 9.2  |   40.9   |   72.1   | 1.01 ± 0.24 |\n|    `pog foo`     |  52.5 ± 8.8  |   40.0   |   77.3   | 1.02 ± 0.24 |\n|  `npm run foo`   | 376.2 ± 10.5 |  352.9   |  385.3   | 7.31 ± 1.21 |\n\n\u003cdetails\u003e\u003csummary\u003eFull Log\u003c/summary\u003e\n\u003cp\u003e\n\n```\nBenchmark 1: ./pog-static foo\n  Time (mean ± σ):      51.4 ms ±   8.4 ms    [User: 40.9 ms, System: 11.3 ms]\n  Range (min … max):    38.4 ms …  69.9 ms    66 runs\n\nBenchmark 2: ./pog foo\n  Time (mean ± σ):      52.5 ms ±   8.8 ms    [User: 41.5 ms, System: 12.6 ms]\n  Range (min … max):    40.0 ms …  77.3 ms    53 runs\n\nBenchmark 3: ./dum foo\n  Time (mean ± σ):      51.9 ms ±   9.2 ms    [User: 41.2 ms, System: 11.1 ms]\n  Range (min … max):    40.9 ms …  72.1 ms    47 runs\n\nBenchmark 4: npm run foo\n  Time (mean ± σ):     376.2 ms ±  10.5 ms    [User: 423.6 ms, System: 51.5 ms]\n  Range (min … max):   352.9 ms … 385.3 ms    10 runs\n\nSummary\n  './pog-static foo' ran\n    1.01 ± 0.24 times faster than './dum foo'\n    1.02 ± 0.24 times faster than './pog foo'\n    7.31 ± 1.21 times faster than 'npm run foo'\n```\n\n\u003c/p\u003e\n\u003c/details\u003e\n\n|                                           Whisker Plot                                           |                                            Histogram                                            |\n| :----------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------: |\n| ![whisker plot of the benchmarks](https://cdn.jsdelivr.net/gh/GeopJr/pog@benchmarks/whisker.svg) | ![histogram of the benchmarks](https://cdn.jsdelivr.net/gh/GeopJr/pog@benchmarks/histogram.svg) |\n\n\u003e Please don't take these benchmarks too seriously.\n\n#\n\n```\n$ pog -h\n\npog v1.0.0\n\nUSAGE:\n    pog [OPTIONS] COMMAND [ARGS]\n\nCOMMANDS:\n    \u003cscript_name\u003e             Run a script\n    run                       List available scripts\n    run \u003cscript_name\u003e         Same as \u003cscript_name\u003e\n    add \u003cpackages\u003e            Same as (p)npm i or yarn add \u003cpackages\u003e\n    i, install                Same as (p)npm/yarn install\n    remove, uninstall         Same as (p)npm/yarn remove\n\nFLAGS:\n    -c INPUT, --cd=INPUT             Change working directory\n    -h, --help                       Show this help\n```\n\n```\n$ pog foo\n\n🍋 foo\n🍋 node stuff/example-script\nfrom example []\n```\n\n```\n$ pog test --1312\n\n🍋 test\n🍋 echo \"hello test\" \u0026\u0026 npm run foo -- arg\nhello test\n\n\u003e foo\n\u003e node stuff/example-script \"arg\" \"--1312\"\n\nfrom example [ 'arg', '--1312' ]\n```\n\n\u003e You can find the above scripts (including the one used in benchmarks) on [dum's repo](https://github.com/egoist/dum/).\n\n#\n\n## Contributing\n\n1. Read the [Code of Conduct](https://github.com/GeopJr/pog/blob/main/CODE_OF_CONDUCT.md)\n2. Fork it ( https://github.com/GeopJr/pog/fork )\n3. Create your feature branch (git checkout -b my-new-feature)\n4. Commit your changes (git commit -am 'Add some feature')\n5. Push to the branch (git push origin my-new-feature)\n6. Create a new Pull Request\n\n#\n\n## Sponsors\n\n\u003cp align=\"center\"\u003e\n\n[![GeopJr Sponsors](https://cdn.jsdelivr.net/gh/GeopJr/GeopJr@main/sponsors.svg)](https://github.com/sponsors/GeopJr)\n\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgeopjr%2Fpog","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgeopjr%2Fpog","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgeopjr%2Fpog/lists"}