{"id":16886086,"url":"https://github.com/vdustr/gsvt","last_synced_at":"2026-02-27T22:42:09.906Z","repository":{"id":86692288,"uuid":"540734045","full_name":"VdustR/gsvt","owner":"VdustR","description":"Tag semantically with one command.","archived":false,"fork":false,"pushed_at":"2023-08-03T04:27:41.000Z","size":39,"stargazers_count":3,"open_issues_count":2,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-14T19:04:34.269Z","etag":null,"topics":["cli","git","node","semantic","semver","version"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/gsvt","language":"TypeScript","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/VdustR.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"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}},"created_at":"2022-09-24T06:37:29.000Z","updated_at":"2023-03-17T13:17:12.000Z","dependencies_parsed_at":null,"dependency_job_id":"2a1f3012-abb0-44e6-b70e-561451c47288","html_url":"https://github.com/VdustR/gsvt","commit_stats":{"total_commits":11,"total_committers":1,"mean_commits":11.0,"dds":0.0,"last_synced_commit":"4779b95013a2f1a8dd704f3fc3eff8b36dfe2792"},"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/VdustR/gsvt","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VdustR%2Fgsvt","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VdustR%2Fgsvt/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VdustR%2Fgsvt/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VdustR%2Fgsvt/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/VdustR","download_url":"https://codeload.github.com/VdustR/gsvt/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VdustR%2Fgsvt/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279020642,"owners_count":26086895,"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-10-14T02:00:06.444Z","response_time":60,"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":["cli","git","node","semantic","semver","version"],"created_at":"2024-10-13T16:38:16.038Z","updated_at":"2025-10-14T19:07:23.977Z","avatar_url":"https://github.com/VdustR.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# gsvt\n\n\u003e Create git semver tags with additional major and minor tags easily\n\n![gsvt](https://vdustr.dev/asset-2022/09-24-gsvt/gsvt-cover.png)\n\n## Example\n\nLet's say the latest tag is `v2.1.1`:\n\n| Command      | Result                 |\n| ------------ | ---------------------- |\n| `gsvt`       | `v2.1.2`, `v2.1`, `v2` |\n| `gsvt major` | `v3.0.0`, `v3.0`, `v3` |\n| `gsvt minor` | `v2.2.0`, `v2.2`, `v2` |\n| `gsvt patch` | `v2.1.2`, `v2.1`, `v2` |\n| `gsvt 1.2.3` | `v1.2.3`, `v1.2`, `v1` |\n\nIf there is no tag matching the pattern `v*.*.*`, the next patch will be `v0.0.1`.\n\n## Why?\n\nUnlike [`npm`](https://www.npmjs.com/), some registry services like [GitHub Actions](https://github.com/features/actions) didn't resolve the version with semantically versioned tags by default. For example, we can install the latest `1.x.x` package with `npm install package@1` but we can't do the same thing with `actions/my-action@v1`. We have to specify the exact version like `actions/my-action@v1.3.5`.\n\n\u003e We recommend creating releases using semantically versioned tags – for example, `v1.1.3` – and keeping major (`v1`) and minor (`v1.1`) tags current to the latest appropriate commit. For more information, see \"[About custom actions](https://docs.github.com/en/actions/creating-actions/about-custom-actions#using-release-management-for-actions)\" and \"[About semantic versioning](https://docs.npmjs.com/about-semantic-versioning). -- [Releasing and maintaining actions - GitHub Docs](\u003chttps://docs.github.com/en/actions/creating-actions/releasing-and-maintaining-actions#:~:text=We%20recommend%20creating%20releases%20using%20semantically%20versioned%20tags%20%E2%80%93%20for%20example%2C%20v1.1.3%20%E2%80%93%20and%20keeping%20major%20(v1)%20and%20minor%20(v1.1)%20tags%20current%20to%20the%20latest%20appropriate%20commit.%20For%20more%20information%2C%20see%20%22About%20custom%20actions%22%20and%20%22About%20semantic%20versioning.\u003e)\n\nThe way to let the user use the action semantically is creating tags with the major version like `v1` and the minor version like `v1.1`, but it's not easy to create these tags manually, so I created this tool to resolve this with one command simply.\n\n## Install\n\n```sh\nnpm install -g gsvt\n```\n\nOr use `npx gsvt` directly without installing.\n\n## Usage\n\n`gsvt` detect the git tags with `v*.*.*` automatically, and create the next patch\nsemver tag.\n\n```sh\ngsvt\n```\n\nYou can increase the version with `major` or `minor`:\n\n```sh\ngsvt major\ngsvt minor\ngsvt patch\n```\n\n`gsvt patch` is equal to `gsvt`.\n\nYou can also specify the version manually:\n\n```sh\ngsvt \u003cversion\u003e\ngsvt v0.1.0\n```\n\nAnd you can push the commit with tags:\n\n```sh\ngit push origin main --tags -f\n```\n\n## License\n\n[MIT](https://github.com/VdustR/gsvt/blob/main/LICENSE)\n\nCopyright (c) 2022-preset ViPro (京京)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvdustr%2Fgsvt","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvdustr%2Fgsvt","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvdustr%2Fgsvt/lists"}