search

prrrnd / atom-git-projects

List and open your local Git projects in Atom.
MIT License
37 stars 18 forks source link

readme

Build Status Code Climate Git projects Git projects

Git projects

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

Git projects

Table of Contents

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

Other

You can follow me on Twitter