Git-Plus package

vim-fugitive like package for atom. make commits and other git things without the terminal

Usage

IMPORTANT:

Make sure your gitconfig file is configured. You must configure at least the user.email and user.name variables.

Also, the package currently favors an ssh setup that doesn't expect to be prompted for credentials in order to push/pull, .etc. Github has a guide to help you set that up here

If you are on a Windows machine, I recommend checking out this thread if you have issues pushing/pulling from a remote repository with this package. I also don't have the means to do my own user testing in a windows environment so I won't be immediately able to help troubleshoot windows problems.

Showing the Git-Plus Palette

Cmd-Shift-H on MacOS

Ctrl-Shift-H on Windows + Linux

Git Plus: Menu on the atom command palette.

Push/Pull/Fetch notifications

Notifications will appear in a console output above the status bar.
This view can be toggled by clicking the 'git+' icon in the bottom right of the status bar.

Auto-Fetch

Keeps your local repo bang up to date by automatically fetching from all remotes in the background every minute by default. But this can be set to any interval up to an hour, or disabled if you prefer. A notification can also be set to keep you informed.

Commands

Commands are accessible for keybindings by dasherizing the command title.

Git Add == git-plus:add

Git Add All Commit And Push == git-plus:add-all-commit-and-push

Note: The following list of commands is not exhaustive. If what you want isn't a feature, you can use Git Run and enter the command.

Command

Effect

Default key binding

Git Run

Execute a custom command. ex. fetch --all

Git Status

Show current status.

Cmd-Shift-A S

Git Add

Add the current file to the index.

Cmd-Shift-A

Git Add All

Adds all files to the index (ex. git add .).

Git Commit

Commit the staged changes. Git-Plus will show an editor for the commit message. To make the commit, save the file. To cancel the commit, close the tab.

Cmd-Shift-C(Ctrl-Shift-X on Windows and Linux)

Git Add And Commit

Stages the current file before preparing a commit. (Git add all and Git commit run in succession)

Cmd-Shift-A c

Git Add All and Commit

Stages all changes before preparing a commit. (Git add all and Git commit in succession)

Cmd-Shift-A a

Git Add And Commit And Push

Commit currently open file and push to a remote repo.

Cmd-Shift-A Q

Git Add All Commit And Push

Commit all changes and push to a remote repo.

Cmd-Shift-A P

Git Commit Amend

Amend the previous commit.

Git Checkout Current File

Undo changes and reset the current file to HEAD.

Git Checkout[ref]

Change to another ref (branch or tag).

Click on status bar branch indicator.

Git Checkout New branch

Create a new branch.

Alt-Click (by default) or right click on status bar branch indicator.

Git Diff [All]

Show the diff for the current file, or all files. The diff can either be against the staged or un-staged tree, as selected in the options.

Git Diff Branches

Show the diff for the current branch all files against another branch.

Git Diff Branche Files

Show the diff for the current branch file against another branch version.

Git[Push⎮Pull]

Push to or pull from a remote repo. If you have multiple remote repos, you can choose which to push to or pull from.

Git Remove [current file]

git rm the current file or open an selector to select the files to remove. You can select multiple files at once.

Git Log [Current File]

Show the commit history [for the current file] and show display the selected commit.

Git Show

Show the specified object, for example HEAD, HEAD~2,3925a0d, origin/master or v2.7.3.

Git Open Changed Files

Open tabs with all added, modified or renamed files.

Git Tags

Operate on tags individually. There are options to add, show, push, checkout, verify, and delete.

Select lists that allow selecting multiple options

Commands like Stage hunk and Cherry-Pick provide a list with the ability to select multiple options.
In this view, there are 'cancel' and 'apply/complete' buttons. The esc key can be used to cancel and
the 'confirm' option can be invoked with shift-enter or ctrl-enter.

Commit Window

To change where the commit window appears go to settings and find

Experimental Features

If you would like to use experimental features, enable them in the package settings.

Custom Commands

If enabled, you can define your own commands in your atom init.coffee or init.js file. These commands will appear in both the atom command palette as well as the Git-Plus command palette. Just like any other commands, you can define keybindings for them as well.