{"id":24582715,"url":"https://github.com/dpaulos6/versify","last_synced_at":"2026-02-13T02:01:46.709Z","repository":{"id":272430058,"uuid":"916068136","full_name":"dpaulos6/versify","owner":"dpaulos6","description":"A Command Line Interface (CLI) tool for automating version bumps","archived":false,"fork":false,"pushed_at":"2025-05-28T09:38:24.000Z","size":15761,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-02T05:36:41.192Z","etag":null,"topics":["automation","bump","cli","git","npm","release","semver","versioning"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/@dpaulos6/versify","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/dpaulos6.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":"2025-01-13T11:52:42.000Z","updated_at":"2025-05-28T09:38:27.000Z","dependencies_parsed_at":"2025-01-15T18:33:13.359Z","dependency_job_id":"1e1fc95f-0ba5-46c7-a609-10d151e89066","html_url":"https://github.com/dpaulos6/versify","commit_stats":null,"previous_names":["dpaulos6/autover","dpaulos6/versify"],"tags_count":68,"template":false,"template_full_name":null,"purl":"pkg:github/dpaulos6/versify","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dpaulos6%2Fversify","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dpaulos6%2Fversify/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dpaulos6%2Fversify/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dpaulos6%2Fversify/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dpaulos6","download_url":"https://codeload.github.com/dpaulos6/versify/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dpaulos6%2Fversify/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29392762,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-13T00:53:09.511Z","status":"online","status_checked_at":"2026-02-13T02:00:10.076Z","response_time":78,"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":["automation","bump","cli","git","npm","release","semver","versioning"],"created_at":"2025-01-24T03:56:36.537Z","updated_at":"2026-02-13T02:01:46.686Z","avatar_url":"https://github.com/dpaulos6.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Versioning Automation CLI\n\nA Command Line Interface (CLI) tool for automating version bumps, Git tagging, and package publishing in your projects. This tool bumps your version based on Semantic Versioning (SemVer) principles, commits and tags the new version in Git, and optionally publishes the package.\n\n## Installation\n\nYou can install the tool globally via npm:\n\n```bash\nnpm install @dpaulos6/versify\n```\n\nYou can also install it globally:\n\n```bash\nnpm install -g @dpaulos6/versify\n```\n\n### Warning\n\nUsing the CLI globally can affect some projects due to possible differences in configuration, such as publish provider (npm, jsr). If you often have different configurations between projects, it's recommended that you install the CLI locally.\n\n## Usage\n\nAfter installing, you can use the `versify` command to bump the version of your project, tag the release in Git, and optionally publish the package.\n\n### Bump the version\n\nTo bump the version, run the following command:\n\n```bash\nversify bump \u003ctype\u003e\n```\n\nWhere `\u003ctype\u003e` can be one of the following:\n\n- `major`: Increments the major version (e.g., `1.0.0` → `2.0.0`).\n- `minor`: Increments the minor version (e.g., `1.1.0` → `1.2.0`).\n- `patch`: Increments the patch version (e.g., `1.1.1` → `1.1.2`).\n\n### Example\n\nTo bump the major version:\n\n```bash\nversify bump major\n```\n\nThis will:\n\n1. Read the current version from `package.json`.\n2. Increment the version based on the specified type (major, minor, or patch).\n3. Update `package.json` with the new version.\n4. Commit all changes to Git with a message `chore: release version \u003cnew_version\u003e`.\n5. Tag the release in Git with the new version.\n6. Optionally push changes to the remote repository.\n7. Optionally publish the package if configured.\n\n### Commit and Tagging\n\nThe version bump command will also create a Git commit with the following message format:\n\n```bash\nchore: release version \u003cnew_version\u003e\n```\n\nAdditionally, it will create a Git tag for the new version, which can be used to track releases.\n\n### Example of a Commit and Tag\n\nFor a bump type of `patch`, the commit message will look like:\n\n```bash\nchore: release version 1.1.2\n```\n\nThe Git tag will be applied as:\n\n```bash\n1.1.2\n```\n\nYou can manually push changes and tags by running:\n\n```bash\ngit push \u0026\u0026 git push --tags\n```\n\n### Package Publishing\n\nIf your project is a package that needs to be published, you can configure the tool to automatically publish the package after versioning.\n\n### Configuration\n\nWhen you run the tool for the first time, you will be prompted to save your configuration settings in a configuration file. The settings include:\n\n1. Do you want to automatically publish the package after versioning?\n2. Do you want to automatically push changes after versioning?\n\nIf the cli founds more than one configuration file (`package.json`, `deno.json`, `jsr.json`, ...), it will prompt you to choose one of them and will use that file for next version bumps.\n\nYou can always change the file by running the setup wizard:\n\n```bash\nversify setup\n```\n\nThe configuration will be saved in a `versify.json` file in your project directory.\n\n### Example Configuration File\n\nThe base configuration is as follows:\n\n```json\n{\n  \"configFile\": \"package.json\",\n  \"shouldPush\": false,\n  \"shouldPublish\": false,\n  \"publish\": {\n    \"name\": \"npm\",\n    \"command\": \"npm publish\",\n    \"options\": [\n      \"--otp\"\n    ]\n  }\n}\n```\n\nIf you want to use default configuration even if you already setup your configuration file, do so by running:\n\n```bash\nversify bump minor -d # use flag -d or --default to ignore your saved configuration and use defaults\n```\n\n### Package Publishing Commands\n\nThe tool supports publishing to npm and jsr:\n\n- `npm` with One-Time Password (OTP) (Will be asked during the version bump process).\n- `jsr` with browser based authentication. (Might not work as expected or even crash due to not being 100% tested yet.)\n\n## License\n\nMIT License. See [LICENSE](LICENSE) for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdpaulos6%2Fversify","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdpaulos6%2Fversify","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdpaulos6%2Fversify/lists"}