Skip to content

purinton/tagit

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

38 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Purinton Dev

@purinton/tagit npm version license build status

Automated version management and Git operations for Node.js and PHP projects.

Note: tagit is intended for use on Linux systems only.


Table of Contents

What is tagit?

tagit is a CLI utility that automates the process of incrementing your project version, updating version files (package.json and/or composer.json), committing the changes, tagging the commit, and pushing to your Git repository. It provides detailed logging and robust error handling for a smooth release workflow.

Features

  • Increments the semantic version in package.json and/or composer.json
  • Writes the new version back to the file(s)
  • Commits all changes with a message like: Version <version> - MM-DD-YYYY
  • Tags the commit with the new version
  • Pushes commits and tags to your remote repository
  • Logs each step for transparency

Installation

Clone the repository (suggested location: /opt):

sudo git clone https://github.com/rpurinton/tagit.git /opt/tagit
cd /opt/tagit
sudo npm install
# (Optional) Run tests
sudo npm test

Create a symlink to make tagit available system-wide:

sudo ln -s /opt/tagit/tagit.mjs /usr/bin/tagit

Usage

Switch to the root directory of the project you want to bump the version for, then run:

tagit

If you have not created the symlink, you can run it directly with:

/opt/tagit/tagit.mjs

Support

For help or questions, join the community and chat with the author:

Discord
Purinton Dev on Discord

License

MIT © 2025 Russell Purinton

Links