Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/nguyenvukhang/ags

ags scans your local git repositories for unstaged files and unpushed commits
https://github.com/nguyenvukhang/ags

bash cli command-line command-line-tool git

Last synced: 19 days ago
JSON representation

ags scans your local git repositories for unstaged files and unpushed commits

Awesome Lists containing this project

README

        

# ags

ags is a minimal tool that provides a summary of the repositories on
your system. ags aims to eliminate the need to navigate to each
repository root just to check for unstaged or uncommitted work.

### Documentation quick links
* [Screenshots](#screenshots)
* [Install](#install)
* [Configuration](#configuration)
* [Uninstall](#uninstall)
* [Running tests](#running-tests)

### Screenshots

ags

![screenshot][ags]

ags -l

![screenshot][ags-l]

### Install

To install, simply download the source and run the install script.

```
git clone https://github.com/nguyenvukhang/ags.git
cd ags && ./install
```

### Configuration

ags doesn't create the config file for you, but it looks for one at
`$HOME/.config/ags/scanlist`. This file should contain a list of paths
to the git repositories on your system, one path per line.

Here's what I used for the screenshot:
```
~/dots
~/dots/personal

~/repos/ags
~/repos/min
~/repos/minnesoda
~/repos/notes

~/sunnus/app/main
~/sunnus/web/dev
```

### Uninstall

To uninstall, execute the install script with a `-d` flag.

```
./install -d
```

### Running tests

To run the full test, use:

```
./test
```

from the repository root.

[ags]: https://raw.githubusercontent.com/wiki/nguyenvukhang/ags/images/ags.png
[ags-l]: https://raw.githubusercontent.com/wiki/nguyenvukhang/ags/images/ags-l.png