{"id":14069386,"url":"https://github.com/tj-actions/git-cliff","last_synced_at":"2025-12-30T01:45:17.079Z","repository":{"id":149282435,"uuid":"612076888","full_name":"tj-actions/git-cliff","owner":"tj-actions","description":":octocat: Github action to run git-cliff with a custom cliff.toml","archived":false,"fork":false,"pushed_at":"2025-07-26T07:26:29.000Z","size":313,"stargazers_count":11,"open_issues_count":1,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-07-26T12:27:02.100Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tj-actions.png","metadata":{"files":{"readme":"README.md","changelog":"HISTORY.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"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,"zenodo":null},"funding":{"github":["jackton1"],"patreon":null,"open_collective":"tj-actions","ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":[]}},"created_at":"2023-03-10T06:30:52.000Z","updated_at":"2025-07-26T07:26:32.000Z","dependencies_parsed_at":"2024-02-19T18:16:58.130Z","dependency_job_id":"917e91f4-e0ed-4cdd-b518-4ef067ee7be4","html_url":"https://github.com/tj-actions/git-cliff","commit_stats":{"total_commits":437,"total_committers":10,"mean_commits":43.7,"dds":0.3135011441647597,"last_synced_commit":"32f9c17d0f09f2a09841dc728addc6ffd7f8b419"},"previous_names":[],"tags_count":20,"template":false,"template_full_name":"tj-actions/docker-action","purl":"pkg:github/tj-actions/git-cliff","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tj-actions%2Fgit-cliff","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tj-actions%2Fgit-cliff/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tj-actions%2Fgit-cliff/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tj-actions%2Fgit-cliff/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tj-actions","download_url":"https://codeload.github.com/tj-actions/git-cliff/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tj-actions%2Fgit-cliff/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267198206,"owners_count":24051546,"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-07-26T02:00:08.937Z","response_time":62,"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-13T07:06:55.011Z","updated_at":"2025-12-30T01:45:17.067Z","avatar_url":"https://github.com/tj-actions.png","language":"Shell","funding_links":["https://github.com/sponsors/jackton1","https://opencollective.com/tj-actions","https://www.buymeacoffee.com/jackton1"],"categories":["Shell"],"sub_categories":[],"readme":"[![Ubuntu](https://img.shields.io/badge/Ubuntu-E95420?style=for-the-badge\\\u0026logo=ubuntu\\\u0026logoColor=white)](https://docs.github.com/en/actions/reference/workflow-syntax-for-github-actions#jobsjob_idruns-on)\n[![Public workflows that use this action.](https://img.shields.io/endpoint?style=for-the-badge\\\u0026url=https%3A%2F%2Fused-by.vercel.app%2Fapi%2Fgithub-actions%2Fused-by%3Faction%3Dtj-actions%2Fgit-cliff%26badge%3Dtrue)](https://github.com/search?o=desc\\\u0026q=tj-actions+git-cliff+path%3A.github%2Fworkflows+language%3AYAML\\\u0026s=\\\u0026type=Code)\n\n[![CI](https://github.com/tj-actions/git-cliff/workflows/CI/badge.svg)](https://github.com/tj-actions/git-cliff/actions?query=workflow%3ACI)\n[![Update release version.](https://github.com/tj-actions/git-cliff/workflows/Update%20release%20version./badge.svg)](https://github.com/tj-actions/git-cliff/actions?query=workflow%3A%22Update+release+version.%22)\n\n\u003c!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section --\u003e\n\n[![All Contributors](https://img.shields.io/badge/all_contributors-2-orange.svg?style=flat-square)](#contributors-)\n\n\u003c!-- ALL-CONTRIBUTORS-BADGE:END --\u003e\n\n## git-cliff\n\nGenerate changelogs for your project with a generated cliff.toml from [`cliff-template.toml`](./cliff-template.toml) or provide a custom template. This eliminates the need to maintain multiple project cliff.toml files.\n\n![screenzy-1682696580397](https://user-images.githubusercontent.com/17484350/235193271-13592c8a-1f3b-4606-9033-eed5d99ac8e1.png)\n\n## Features\n\n*   Generates changelogs using [git-cliff](https://github.com/orhun/git-cliff).\n*   Utilizes a generic [`cliff-template.toml`](./cliff-template.toml) for easy configuration.\n*   Supports custom templates via file path or URL.\n*   Dynamically replaces values via [Github context object](https://docs.github.com/en/actions/learn-github-actions/contexts)\n*   Falls back to project's cliff.toml if one exists\n\n## Usage\n\n```yaml\n...\n    runs-on: ubuntu-latest\n    steps:\n      - name: Checkout\n        uses: actions/checkout@v4\n        with:\n          fetch-depth: 0\n      - name: Run git-cliff\n        uses: tj-actions/git-cliff@679041f051a4d2ab452f7e5e7b0eed2abee21131 # v2\n```\n\n## Inputs\n\n\u003c!-- AUTO-DOC-INPUT:START - Do not remove or modify this section --\u003e\n\n```yaml\n- uses: tj-actions/git-cliff@679041f051a4d2ab452f7e5e7b0eed2abee21131 # v2\n  id: git-cliff\n  with:\n    # Extra args passed directly to \n    # [git-cliff](https://github.com/orhun/git-cliff#command-line-arguments) \n    # Type: string\n    # Default: \"--verbose\"\n    args: ''\n\n    # Provide the version for git-cliff. \n    # e.g latest, v2.10.0 \n    # Type: string\n    # Default: \"latest\"\n    git-cliff-version: ''\n\n    # Output file\n    # Type: string\n    # Default: \"HISTORY.md\"\n    output: ''\n\n    # Path or URL to the \n    # template `cliff.toml` config file. See \n    # [`cliff-template.toml`](./cliff-template.toml) for a working example. \n    # **NOTE:** Only the `REPOSITORY_URL` is \n    # substituted. \n    # Type: string\n    template-config: ''\n\n    # GITHUB_TOKEN or a Repo scoped \n    # PAT \n    # Type: string\n    # Default: \"${{ github.token }}\"\n    token: ''\n\n```\n\n\u003c!-- AUTO-DOC-INPUT:END --\u003e\n\n*   Free software: [MIT license](LICENSE)\n\nIf you feel generous and want to show some extra appreciation:\n\n[![Buy me a coffee][buymeacoffee-shield]][buymeacoffee]\n\n[buymeacoffee]: https://www.buymeacoffee.com/jackton1\n\n[buymeacoffee-shield]: https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png\n\n## Credits\n\nThis package was created with [Cookiecutter](https://github.com/cookiecutter/cookiecutter) using [cookiecutter-action](https://github.com/tj-actions/cookiecutter-action)\n\n*   [git-cliff](https://github.com/orhun/git-cliff)\n\n## Report Bugs\n\nReport bugs at https://github.com/tj-actions/git-cliff/issues.\n\nIf you are reporting a bug, please include:\n\n*   Your operating system name and version.\n*   Any details about your workflow that might be helpful in troubleshooting.\n*   Detailed steps to reproduce the bug.\n\n## Contributors ✨\n\nThanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):\n\n\u003c!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section --\u003e\n\n\u003c!-- prettier-ignore-start --\u003e\n\n\u003c!-- markdownlint-disable --\u003e\n\n\u003ctable\u003e\n  \u003ctbody\u003e\n    \u003ctr\u003e\n      \u003ctd align=\"center\" valign=\"top\" width=\"14.28%\"\u003e\u003ca href=\"https://visualon.de\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/1798109?v=4?s=100\" width=\"100px;\" alt=\"Michael Kriese\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eMichael Kriese\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/tj-actions/git-cliff/commits?author=viceice\" title=\"Code\"\u003e💻\u003c/a\u003e\u003c/td\u003e\n      \u003ctd align=\"center\" valign=\"top\" width=\"14.28%\"\u003e\u003ca href=\"https://home.boidol.dev/\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/652404?v=4?s=100\" width=\"100px;\" alt=\"Raphael Boidol\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eRaphael Boidol\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/tj-actions/git-cliff/commits?author=boidolr\" title=\"Documentation\"\u003e📖\u003c/a\u003e\u003c/td\u003e\n    \u003c/tr\u003e\n  \u003c/tbody\u003e\n\u003c/table\u003e\n\n\u003c!-- markdownlint-restore --\u003e\n\n\u003c!-- prettier-ignore-end --\u003e\n\n\u003c!-- ALL-CONTRIBUTORS-LIST:END --\u003e\n\nThis project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftj-actions%2Fgit-cliff","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftj-actions%2Fgit-cliff","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftj-actions%2Fgit-cliff/lists"}