fugitive ·

Simple command line tool to make git more intuitive, along with useful GitHub addons.

fugitive provides new or alternative commands to use with git, and also adds a few helpful tools for GitHub repositories.

It's similar to [git-extras][gitextras] but is designed to be more portable. git-extras is written entirely as a set of shell scripts, which means platform support outside Unix is at best hit or miss.

On the other hand, fugitive is written in [Nim][nim] to allow for better portability. Other benefits are that Nim is super fast, flexible, and more readable than the often cryptic bash syntax.

[Git Town][gittown] is a project with similar goals written in Go.

installation

Linux, Windows, and macOS prebuilt binaries are available from [releases][releases]. Download the file for your system from the latest release and extract the binary within to somewhere in your $PATH.

Alternatively if you have [Nim][nim] and [Nimble][nimble] installed ( and ~/.nimble/bin is in your path ), you can also simply run:

nimble install fugitive

This will make the latest version of fugitive available to you anywhere. Check out [Nimble][nimble] if you'd like to know more about package installation.

usage

Usage: fugitive [command] [...args] (...options)
Commands:   alias     [name [--remove|-r]] [expansion]                                  List, add, or remove git aliases   config    [key] [value] [--remove|-r]                                  Set, update, or remove fugitive settings   changelog [file] [--tag|-t:<tag>] [--last-tag|-l:<tag>] [--overwrite|-o]             [--no-anchor] [--no-title] [--no-divider] [--init]                                  Write a list of changes since last tag or between two tags   clone     <...repos>           Alias for fugitive mirror   install   [--override|-o] [--force|-y]                                  Alias various fugitive commands as git subcommands   lock      <...files>           Prevent changes to the specified files from being tracked   mirror    <...repos>           Wrapper around git clone with various URL shorthands   open      [repo]               Open the current or specified repository's homepage   profile   [username]           View a summary of a GitHub user profile   release   <tag> [--repo|-r:<repo>] [--file|-f:<filepath>] [--description|-d:<desc>]             [--desc-file|-D:<filepath>] [--draft|-N] [--prerelease|-p]             [--target-commit|-T:<commitish>]                                  Create a GitHub release and/or upload assets to a release   scrap     <...files>  [--all|-a]                                  Discard local changes to the specified files   summary                        Summarize git repository statistics   undo      [#] [--hard|-h]      Undo the last commit ( or last # commits )   uninstall                      Remove git aliases added by install   unlock    <...files>           Resume tracking changes to these locked files   unstage   <...files> [--all|-a]                                  Remove files from the git stage area
Options:   --help, -h       Show this help message   --version, -v    Output the fugitive version number

For help on a specific command, provide the --help/-h flag after that command, ie. fugitive changelog -h.

configuration

fugitive stores a configuration file in your user configuration directory called fugitive.ini. You can manage this file using the fugitive config command.

TIP: Using the fugitive config command with no arguments will print the full

filepath to your config file.

You can, for example, tell fugitive explicitly what to use as your GitHub username when using various shorthand features:

fugitive config github.username <name>

Here's the full list of available settings:

| setting name | type | default value | | --------------- | -------- | ------------- | | terminal_colors | bool | on | | github.username | string | - |

Settings of the type bool are retrieved using Nim's [parseBool][nimparsebool],

so they can be set to any of y, yes, true, 1, on or n, no, false, 0, off.

username

Some commands support a shorthand for referring to GitHub repositories, provided you've configured your GitHub username or it can be inferred from your git config.

<name>

The simplest shorthand is for referencing one of your own repositories, which you can do by simply entering its name. For example if you're [@haltcase][haltcase], entering fugitive open cascade would open your browser to [cascade][cascade].

<owner>/<name>

You can also use any <owner>/<project> combination you'd like, such as:

• fugitive open nim-lang/nim
• fugitive mirror soasme/nim-markdown

alias installation

After installation, you can make some of fugitive's commands more accessible by running fugitive install, which will attach them to git as subcommands, making git undo == fugitive undo.

Commands installed to git include:

alias
changelog
lock
mirror
open
profile
release
scrap
summary
undo
unlock
unstage

Existing aliases are safe as fugitive will not override them unless the --override ( or -o ) flag is explicitly passed.

If you want to remove these installed aliases, use fugitive uninstall. Only aliases that fugitive installed and match the fugitive command will be removed.

Note the mirror command - git commands can't be overridden, so while

fugitive clone is possible it can't be aliased as a git subcommand.

Therefore fugitive mirror is the main command and the one that will

be attached to git, while clone is just an alias for convenience.

building

To build fugitive from source you'll need to install [Nim][nim] and its package manager [Nimble][nimble].

• Clone the repo: git clone https://github.com/haltcase/fugitive.git
• Move into the newly cloned directory: cd fugitive
• Compile a development build for your current platform: nimble build
• Compile a release build for your current platform: nimble release

contributing

This project is open to contributions of all kinds! Please check and search the [issues][issues] if you encounter a problem before opening a new one. [Pull requests][prinfo] for improvements are also welcome — see the steps above for development.

license

MIT © Bo Lingen / haltcase

[gitextras]: https://github.com/tj/git-extras [gittown]: https://github.com/Originate/git-town [nim]: https://nim-lang.org [nimble]: https://github.com/nim-lang/nimble [issues]: https://github.com/haltcase/fugitive/issues [releases]: https://github.com/haltcase/fugitive/releases [haltcase]: https://github.com/haltcase [cascade]: https://github.com/haltcase/cascade [prinfo]: https://help.github.com/articles/creating-a-pull-request/ [nimparsebool]: https://nim-lang.org/docs/strutils.html#parseBool%2Cstring