GO GitHub project manager

gogh is forked from ghq.

$ gogh list
github.com/kyoh86/git-branches
github.com/kyoh86/gogh
github.com/kyoh86/vim-wipeout
github.com/kyoh86-tryouts/bare
github.com/nvim-telescope/telescope.nvim
...

gogh provides a way to organize remote repository clones, like go get does. When you clone a remote repository by gogh get, gogh makes a directory under a specific root directory (by default ~/go/src) using the remote repository URL's host and path. And creating new one by gogh new, gogh make both of a local project and a remote repository.

$ gogh get https://github.com/kyoh86/gogh
# Runs `git clone https://github.com/kyoh86/gogh ~/go/src/github.com/kyoh86/gogh`

You can also list projects (local repositories) (gogh list).

$ go install github.com/kyoh86/gogh/cmd/gogh@latest

If you want zsh-completions, you can create completions file like this:

$ echo "autoload -Uz compinit && compinit" >> ~/.zshrc
$ gogh completion zsh > $fpath[1]/_gogh

$ brew tap kyoh86/tap
$ brew update
$ brew install kyoh86/tap/gogh

$ mkdir -p gogh_build && \
  cd gogh_build && \
  curl -L --silent https://github.com/kyoh86/gogh/releases/latest/download/gogh_PKGBUILD.tar.gz | tar -xvz
$ makepkg -i

gogh manages repositories in multiple servers that is pairs of an owner and a host name. To login in new server or logout, you should use auth login with personal access tokens.

You should generate personal access tokens with repository permissions:

• ✔️ Read access to code and metadata
• ✔️ Read and Write access to administration

See manual for detail: usage/gogh.md.

Use gogh [command] --help for more information about a command. Or see the manual in usage/gogh.md.

gogh manages projects under the roots directories.

See also: Directory structures

You can change the roots with roots add <path> or roots remove <path> and see all of them by roots list. gogh uses the first one as the default one, create, fork or clone will put a local project under it. If you want to change the default, use roots set-default <path>.

Default: ~/Projects.

When you specify a repository with ambiguous user or host, it will be interpolated with a default value. You may set them with set-default.

If you set them like below:

ambiguous repository names will be interpolated:

NOTE: default host will be "github.com" if you don't set it.

Local projects are placed under gogh.roots with named `host/user/repo.

~/Projects
+-- github.com/
|-- google/
|   +-- go-github/
|-- kyoh86/
|   +-- gogh/
+-- alecthomas/
  +-- kingpin/

This software is released under the MIT License, see LICENSE. And this software is based on ghq.