Get Git info from a working copy and populate grunt.config with the data
Switch branches/tags
Nothing to show
Latest commit b6db800 May 5, 2016 @damkraw Merge pull request #28 from CptNippel/master
Fix using author-date and author-name instead of commit-date and commit-name
Failed to load latest commit information.
tasks Fix using author-date and author-name instead of commit-date and comm… Feb 18, 2016
.gitignore node.extend cherrypicked Jan 9, 2014
LICENSE-MIT initial May 15, 2013 readme fix May 5, 2016
package.json release 0.1.8 May 5, 2016


Get Git info from a working copy and populate grunt.config with the data

Getting Started

This plugin requires Grunt >=0.4.0

If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:

npm install grunt-gitinfo --save-dev

Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:


The "gitinfo" task


Inspired by grunt-svninfo. In your project's Gruntfile, add a section named gitinfo to the data object passed into grunt.initConfig(). Executing the task will populate grunt.config.gitinfo with repository data described below. You can use gitinfo object in your build as e.g. <%= gitinfo.local.branch.current.SHA %>. The resulting gitinfo object has the following structure:

    local : {
        branch : {
            current : {
                SHA               : "Current HEAD SHA",
                shortSHA          : "Current HEAD short SHA",
                name              : "Current branch name",
                currentUser       : "Current git user",
                lastCommitTime    : "Last commit time",
                lastCommitMessage : "Last commit message",
                lastCommitAuthor  : "Last commit author",
                lastCommitNumber  : "Last commit number"
    remote : {
        origin : {
            url : "Branch Url"
    (custom command values)



Type: String

Allows to specify a cwd (current working directory) path repository. The default directory is the where you run grunt from ('.').


gitinfo: {
    options: {
        cwd: './myproject/ishere'

Custom commands

Type: Object

Allows to specify a custom git command.


gitinfo: {
    commands: {
        'my.custom.command' : ['arg1', 'arg2', (...)] // git arg1 arg2 (...)

This will populate <%= %> with git arg1 arg2 output.


In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using Grunt.

Release History


  • #30 Update peerDependencies to support Grunt 1.0


  • #19 Added the command lastCommitMessage
  • #18 Update dependencies
  • #17 Fix JSHint warnings about if-else braces


  • Removed tag from commands list
  • #13 Adding lastCommitNumber command
  • #12 Logging through grunt.log API
  • #9 Extend existing gitinfo config