gitto/README.org
2015-07-12 10:55:45 +02:00

1.5 KiB

gitto

NAME

gitto - A silly utility to track the status of some git repositories.

SYNOPSIS

gitto [command [subcommand] [args...]]

DESCRIPTION

For lack of a better title.

My simple utility to keep track of all the git repositories I have on my computer(s). Also an experiment in writing scheme.

Written for GNU Guile 2.0.9 or newer

USAGE

Usage is, hopefully, simple, first you have to register some repos:

$ gitto add ~/projects/project1
$ gitto add ~/projects/project2
$ gitto add ~/projects/project3

Then you can call gitto without any argument to see a list of your repos and their statuses:

$ gitto
project1: Worktree is dirty
  master:      0 to push and 0 to pull. Last update: 4 weeks ago

project2: Worktree is clean
  master:      5 to push and 2 to pull. Last update: 2 days ago

project3: Worktree is clean
  master:      0 to push and 1 to pull. Last update: 1 hour ago

If you're done with one of your projects and no longer wish to track their status you can unregister them:

$ gitto remove ~/projects/project1

If you require further assistance:

$ gitto help

run-gitto

It is not strictly necessary to install gitto, I have added a utility to run it straight from the project directory, although mostly for testing purposes.

Using run-gitto works exactly the same as using gitto when it is installed.