# git-projects

See the state of git projects on a system.

It shows you whether your current repo has any diffs, and whether
local branches are ahead of/behind their remote counterparts. By
default it doesn't do a fetch first, but you can ask it to by
specifying `--fetch`.

_N.B. This is a very young project, but the basic functionality is
enough to be useful._


## Installation

```txt
$ cargo install git-projects
```


## Usage

1. Create a file, `~/.git-projects.toml`, with the projects you want to
monitor. Tilde and environment expansions are allowed, according to
[shellexpand::full()]:

```toml
repos = [
    "/usr/local/whatever",
    "~/src/another/",
]
```

If `git-projects` sees a `.git-projects.toml` file in the current
directory, that will override the one found in `~/`.

2. Run `git-projects` to see the current state of those projects:

```txt
/usr/local/whatever:
    main: Behind 95
    my-local-branch: Behind 3
~/src/another/:
    2 diffs
    main: Behind 1
```

3. Run `git-projects --fetch` to do a `git --fetch` on those projects
before showing their state.