Git projects

Git projects is a package for Atom, which allows you to quickly list and open your local git repositories.

Table of Contents

• Installation
• Usage
• Settings
• Project-specific configuration
• Known issues
• Other

Installation

Simply run the following command:

apm install git-projects

Or find the package in Atom → Settings → Install and search for "git-projects"

Usage

Press ctrl + alt + o or type Git Projects: Toggle in the Command Palette to open project in a new window.

Press ctrl + alt + shift + o or type Git Projects: Toggle Add in the Command Palette to add project to current window.

Settings

Key	Default value	Possible values
rootPath	~/repos	One or more directories containing projects, sep. by ;
ignoredPath		One or more directories containing projects, sep. by ;
ignoredPatterns	node_modules;.git	One or more patterns to ignore, sep. by ;
sortBy	"Project name"	"Project name", "Last modification date", "Size"
openInDevMode	false	true, false
showGitInfo	true	true, false
maxDepth	5	Max number of directories to traverse from root

Project-specific configuration

Git projects will read the content of any .git-project file located at the root of your Git repository (project). You can set a custom title for any project that will be shown in the list view. Here is an example:

{
  "title": "Project Title"
}

If you don't want a project to be listed, add a .git-project file at its root with the following content:

{
  "ignored": true
}

The project icon can also be customized.

{
  "title": "Custom icon",
  "icon": "icon-file-text"
}

Known issues

• Windows/linux users and git-utils

Other

You can follow me on Twitter