{"id":21029425,"url":"https://github.com/dsoftwareinc/github-actions-cli","last_synced_at":"2025-10-04T21:46:41.495Z","repository":{"id":183051846,"uuid":"669542478","full_name":"dsoftwareinc/github-actions-cli","owner":"dsoftwareinc","description":"GitHub Actions CLI - allows updating workflows, etc.","archived":false,"fork":false,"pushed_at":"2025-04-21T17:59:50.000Z","size":438,"stargazers_count":5,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-21T18:45:48.363Z","etag":null,"topics":["cli","github-actions"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dsoftwareinc.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":".github/CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":"cunla"}},"created_at":"2023-07-22T16:06:06.000Z","updated_at":"2025-04-21T17:59:53.000Z","dependencies_parsed_at":null,"dependency_job_id":"f9373631-c426-4484-bc0c-31709e62fcb1","html_url":"https://github.com/dsoftwareinc/github-actions-cli","commit_stats":null,"previous_names":["dsoftwareinc/github-actions-cli"],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dsoftwareinc%2Fgithub-actions-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dsoftwareinc%2Fgithub-actions-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dsoftwareinc%2Fgithub-actions-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dsoftwareinc%2Fgithub-actions-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dsoftwareinc","download_url":"https://codeload.github.com/dsoftwareinc/github-actions-cli/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254330721,"owners_count":22053034,"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":["cli","github-actions"],"created_at":"2024-11-19T12:12:21.394Z","updated_at":"2025-10-04T21:46:36.473Z","avatar_url":"https://github.com/dsoftwareinc.png","language":"Python","funding_links":["https://github.com/sponsors/cunla"],"categories":[],"sub_categories":[],"readme":"GitHub Actions CLI\n====================\n\nThe purpose of this tool is to work with your GitHub Actions workflows in your repositories.\nIt is complementary to the GitHub CLI.\n\n# Basic usage\n\nRun `github-actions-cli` within a directory which has a clone of a GitHub repository.\nThe tool will list the GitHub actions workflows, the actions they use, the current versions they use, and the latest\nversions of the actions.\n\n```text\n./.github/workflows/test.yml:\n\tactions/checkout                  v2 ==\u003e v3\n\trelease-drafter/release-drafter    v5\n\tactions/setup-python              v4\n./.github/workflows/publish.yml:\n\tpypa/gh-action-pypi-publish       v1\n\tactions/checkout                  v2 ==\u003e v3\n\tactions/setup-python              v3 ==\u003e v4\n```\n\n# Supported use cases\n\n```text\nUsage: github-actions-cli [OPTIONS] COMMAND [ARGS]...\n\nOptions:\n  --repo TEXT               Repository to analyze, can be a local directory or\n                            a {OWNER}/{REPO} format  [default: .]\n  --github-token TEXT       GitHub token to use, by default will use\n                            GITHUB_TOKEN environment variable\n  --compare-exact-versions  Compare versions using all semantic and not only\n                            major versions, e.g., v1 will be upgraded to\n                            v1.2.3\n  --help                    Show this message and exit.\n\nCommands:\n  list-actions    List actions in a workflow\n  list-workflows  List workflows in repository\n  update-actions  Show actions required updates in repository workflows\n```\n\n## `update-actions` List all actions that are out of date in a repository (Default)\n\nList the latest versions of actions used in a repository workflows\nand potentially update the workflow files.\n\nFor example, running `github-actions-cli` without any parameters will look for workflows in the\ncurrent directory (`.`), check whether there are updates required for the actions in the workflows\nit finds.\n\nAnother example, running on a remote repository, `github-actions-cli -repo cunla/fakeredis update-actions -u`,\nwill look for the latest versions of the actions used in the repository cunla/fakeredis, and because of the `-u`\nflag, it will create a commit updating the workflows to the latest.\n\n\u003e Note:\n\u003e Having `GITHUB_TOKEN` with permissions to make commits on the repository\n\u003e is required in order to write to repository.\n\nParameters:\n\n```text\nUsage: github-actions-cli update-actions [OPTIONS]\n\n  Show actions required updates in repository workflows\n\nOptions:\n  -u, --update      Update actions in workflows (For remote repos: make\n                    changes and commit, for local repos: update files)\n  -commit-msg TEXT  Commit msg, only relevant when remote repo  [default:\n                    chore(ci):update actions]\n  --help            Show this message and exit.\n```\n\nIf you want the check to compare exact versions and not only major versions, use the `--compare-exact-versions` flag.\n\n## `list-workflows` List all workflow paths and names in a specified repository.\n\nExample:\n\n```shell\ngithub-actions-cli --repo cunla/fakeredis list-workflows\n```\n\nwill return:\n\n```text\n.github/workflows/publish.yml\n.github/workflows/test.yml\n```\n\n## `list-actions` List all actions `uses` in a workflow\n\nGiven a repo and a workflow path, return all actions in the workflow.\n\nExample:\n\n```shell\ngithub-actions-cli --repo cunla/fakeredis list-actions .github/workflows/test.yml\n```\n\nResult\n\n```text\nactions/checkout@v3\n./.github/actions/test-coverage\nrelease-drafter/release-drafter@v5\nactions/setup-python@v4\n```\n\n# Installation\n\n```shell\npip install github-actions-cli\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdsoftwareinc%2Fgithub-actions-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdsoftwareinc%2Fgithub-actions-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdsoftwareinc%2Fgithub-actions-cli/lists"}