{"id":13657596,"url":"https://github.com/brickpop/runner-cli","last_synced_at":"2025-08-16T21:31:42.581Z","repository":{"id":78772123,"uuid":"141701561","full_name":"brickpop/runner-cli","owner":"brickpop","description":"A universal task runner wrapper. Supporting NPM scripts, Gulp, Makefiles and shell scripts","archived":false,"fork":false,"pushed_at":"2018-11-18T15:40:25.000Z","size":59,"stargazers_count":22,"open_issues_count":3,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-08-11T20:57:30.456Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://medium.com/ledfusion/a-universal-task-runner-to-run-them-all-d93f1a1bf8b1","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/brickpop.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2018-07-20T11:00:20.000Z","updated_at":"2023-02-25T20:48:32.000Z","dependencies_parsed_at":"2023-03-16T18:00:11.481Z","dependency_job_id":null,"html_url":"https://github.com/brickpop/runner-cli","commit_stats":null,"previous_names":["ledfusion/runner-cli"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/brickpop/runner-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brickpop%2Frunner-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brickpop%2Frunner-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brickpop%2Frunner-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brickpop%2Frunner-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/brickpop","download_url":"https://codeload.github.com/brickpop/runner-cli/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brickpop%2Frunner-cli/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270109283,"owners_count":24528783,"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","status":"online","status_checked_at":"2025-08-12T02:00:09.011Z","response_time":80,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":[],"created_at":"2024-08-02T05:00:46.165Z","updated_at":"2025-08-16T21:31:42.300Z","avatar_url":"https://github.com/brickpop.png","language":"JavaScript","readme":"# runner-cli\nA universal task runner, with support for NPM scripts, Gulp, Makefiles and shell scripts\n\nThe tool is currently a work in progress.\n\n## Usage\n\nInstall it on your system:\n\n```\nnpm i -g runner-cli\n```\n\nTo display the available actions:\n\n```\nrun\n```\n\nThe command above will attempt to locate `package.json`, `gulpfile.js`, `makefile` and `taskfile` and display the available commands.\n\nTo run a task:\n\n```\nrun action\n```\n\nThe command above will attempt to run `npm run action`, `gulp action`, `make action` and `bash taskfile action`.\n\n### Invocation examples\n\nLet's assume that we have a `main` action that depends on actions `one` and `two` (check the examples folder).\n\nIf the project has a `gulpfile.js`:\n\n```\n$ run main\ngulp main\n\n[18:13:23] Using gulpfile ~/git/runner-cli/example/gulpjs/gulpfile.js\n[18:13:23] Starting 'one'...\nThis is task 1\n[18:13:23] Finished 'one' after 152 μs\n[18:13:23] Starting 'two'...\nThis is task 2\n[18:13:23] Finished 'two' after 90 μs\n[18:13:23] Starting 'main'...\nThis is the main task\n[18:13:23] Finished 'main' after 67 μs\n```\n\nIf the project has a `package.json`:\n\n```\n$ run main\nnpm run main\n\n\n\u003e runner-cli-npm-example@1.0.0 main /Users/jordi/git/runner-cli/example/npm\n\u003e run one \u0026\u0026 run two\n\nnpm run one\n\n\n\u003e runner-cli-npm-example@1.0.0 one /Users/jordi/git/runner-cli/example/npm\n\u003e echo 'This is action 1'\n\nThis is action 1\nnpm run two\n\n\n\u003e runner-cli-npm-example@1.0.0 two /Users/jordi/git/runner-cli/example/npm\n\u003e echo 'This is action 2'\n\nThis is action 2\n```\n\nIf the project has a `makefile`:\n\n```\n$ run main\nmake main\n\nThis is action one\nThis is action two\nThis is the main action\n```\n\nIf the project has a `taskfile`:\n\n```\n$ run main\nbash taskfile main\n\nThis is the main action\n\nSequential actions:\n\u003e This is action one\n\u003e This is action two (parameter $1 = testing)\nActions one and two completed\n\nConcurrent actions:\n\u003e This is action two (no parameter)\n\u003e This is action one\nActions one and two completed concurrently\n\nTask completed in 0m0.002s\n```\n\n### Display available commands\n\nIn the same scenario as before, we just execute `run`:\n\nIf the project has a `gulpfile.js`:\n```\n$ run\ngulp --tasks\n\n[18:01:14] Using gulpfile ~/git/runner-cli/example/gulpjs/gulpfile.js\n[18:01:14] Tasks for ~/git/runner-cli/example/gulpjs/gulpfile.js\n[18:01:14] ├── one\n[18:01:14] ├── two\n[18:01:14] └─┬ main\n[18:01:14]   ├── one\n[18:01:14]   └── two\n```\n\nIf the project has a `package.json`:\n```\n$ run\nnpm run\n\nScripts available in runner-cli-npm-example via `npm run-script`:\n  one\n    echo 'This is action 1'\n  two\n    echo 'This is action 2'\n  main\n    run one \u0026\u0026 run two\n```\n\nIf the project has a `makefile`:\n```\n$ run\nmake\n\nAvailable actions:\n\n  $ make         Runs 'make info' by default\n  $ make info    Shows this text\n\n  $ make one     Action one\n  $ make two     Action two\n  $ make main    The main action\n```\n\nIf the project has a `taskfile`:\n```\n$ run\nbash taskfile\n\ntaskfile \u003ctask\u003e \u003cargs\u003e\n\nAvailable tasks:\n     1\tdefault\n     2\tmain\n     3\tone\n     4\ttwo\nTask completed in 0m0.004s\n```\n\n### Why a meta task runner\nRead the [motivational article on Medium.com](https://medium.com/jordi-moraleda/a-universal-task-runner-to-run-them-all-d93f1a1bf8b1)\n\n### Roadmap:\n- [x] Run tasks from `package.json`\n- [x] Run tasks from `gulpfile.js`\n- [x] Run tasks from `makefile`\n- [x] Run tasks from [taskfile's](https://hackernoon.com/introducing-the-taskfile-5ddfe7ed83bd) (shell scripts exposing functions)\n- [x] Display the available tasks\n- [x] Detect and prompt for installation if a tool is missing\n- [x] Install local Gulp if missing\n- [x] Generate templates for the supported formats\n","funding_links":[],"categories":["JavaScript"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrickpop%2Frunner-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbrickpop%2Frunner-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrickpop%2Frunner-cli/lists"}