README.md

git-subtree

Git-subtree help you working with subtree commands.

Using a subtrees config file, you can clone a project and create all subtree remotes with one command. It also helps working with push/pull commands, adding prefix and branch from config.

Requeriments

• NodeJS
• Git subtree

Install

$ npm install -g git-subtree

Configuration file

The git-subtree configuration must be stored in subtrees.json file in the project root.

{ 
	"mysubtree" : {
		"localFolder": "subtrees/mysubtree",
		"repository": "https://github.com/username/myrepo.git",
		"branch": "master"
	}
}

Use

$ gitsbt <command>

Init

$ gitsbt init [username]

This command creates all remotes from subtrees config and if it's a new project, where subtrees folders are still not created, will fetch from subtree remote and add the subtree.

Add

$ gitsbt add <subtree> [username]

Adds git remote, fetch it and creates the local folder with subtree content.

Pull

$ gitsbt pull <subtree>

Pulls subtree changes from subtree remote.

Push

$ gitsbt push <subtree>

Pushes subtree changes.

Commit

$ gitsbt commit <subtree> <message>

Commits subtree pending changes.