Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/awaescher/repoz

👨‍💻 A zero-conf git repository hub for Windows and macOS with Windows Explorer- & CLI-enhancements
https://github.com/awaescher/repoz

explorer-integration git posh-git repositories repository status

Last synced: 7 days ago
JSON representation

👨‍💻 A zero-conf git repository hub for Windows and macOS with Windows Explorer- & CLI-enhancements

Awesome Lists containing this project

README 

        
[![Maintainability Rating](https://sonarcloud.io/api/project_badges/measure?project=awaescher_RepoZ&metric=sqale_rating)](https://sonarcloud.io/dashboard?id=awaescher_RepoZ)

[![Reliability Rating](https://sonarcloud.io/api/project_badges/measure?project=awaescher_RepoZ&metric=reliability_rating)](https://sonarcloud.io/dashboard?id=awaescher_RepoZ)

[![Security Rating](https://sonarcloud.io/api/project_badges/measure?project=awaescher_RepoZ&metric=security_rating)](https://sonarcloud.io/dashboard?id=awaescher_RepoZ)

[![Bugs](https://sonarcloud.io/api/project_badges/measure?project=awaescher_RepoZ&metric=bugs)](https://sonarcloud.io/dashboard?id=awaescher_RepoZ)

[![Vulnerabilities](https://sonarcloud.io/api/project_badges/measure?project=awaescher_RepoZ&metric=vulnerabilities)](https://sonarcloud.io/dashboard?id=awaescher_RepoZ)



[![Build Status](https://dev.azure.com/awaescher/osspipeline/_apis/build/status/Cake-Win)](https://dev.azure.com/awaescher/osspipeline/_build/latest?definitionId=4)



# RepoZ



RepoZ is a zero-conf git repository hub with Windows Explorer- & CLI-enhancements. It uses the git repositories on your machine to create an efficient navigation widget and makes sure you'll never lose track of your work along the way.



It's populating itself as you work with git. It does not get in the way and does not require any user attention to work.



RepoZ will not compete with your favourite git clients, so keep them. It's not about working within a repository: It's a new way to use all of your repositories to make your daily work easier.



📦  [Check the Releases page](https://github.com/awaescher/RepoZ/releases) to **download** the latest version and see **what's new**!



🍫  Available on [chocolatey](https://chocolatey.org/packages/repoz) as well, just use `choco install repoz`.



## The Hub

The hub provides a quick overview of your repositories including their current branch and a short status information. Additionally, it offers some shortcuts like revealing a repository in the Windows Explorer or macOS Finder, opening a command line tool in a given repository and checking out git branches.



RepoZ is available for Windows and macOS.



![Screenshot](https://raw.githubusercontent.com/awaescher/RepoZ/master/_doc/RepoZ-ReadMe-UI-Both.png)



> **"Well ok, that's a neat summary ..."** you might say **"... but how does this help?"**.



If you are working on different git repositories throughout the day, you might find yourself wasting time by permanently switching over from one repository to another. If you are like me, you tend to keep all those windows open to be reused later, ending up on a window list which has to be looped through all the time.



With RepoZ, you can instantly jump into a given repository with a file browser or command prompt. This is shown in the following gif.



![Navigation](https://raw.githubusercontent.com/awaescher/RepoZ/master/_doc/QuickNavigation.gif)



For Windows, use the hotkeys Ctrl+Alt+R to show RepoZ. On Mac it's Command+Alt+R*. 



To open a file browser, simply press Return on the keyboard once you selected a repository. To open a command prompt instead, hold Ctrl on Windows or Command on macOS while pressing Return. These modifier keys will also work with mouse navigation.



* On Mac you need to give RepoZ access to the [keyboard events in the system privacy settings](http://mizage.com/help/accessibility.html). Once you have done this, you might need to restart the app.



## Command Line Sidekick

RepoZ is a UI-centered tool but comes with a sidekick app called **grr** to empower the command line hackers. 

With **grr**, the information from RepoZ can be brought to any command line tool.



It supports ...

 - listing all repositories found in RepoZ including their branch and status information

 - filtering for repository [names, branches or paths](https://github.com/awaescher/RepoZ/issues/68#issuecomment-478764341) (to list or jump) by RegEx patterns, like `grr [M.*]`

 - jumping directly to a repository path by adding the `cd` command, like `grr cd MyRepo`

 - opening a file browser in a repository from anywhere in your command prompt with `grr open MyRepo`

 - list files in a repository following a pattern with `grr list MyRepo *.sln` (add `-r` for recursive search)

 - open files in a repository directly with `grr open MyRepo *.sln` (add `-e` for elevated mode, "as Admin")

 

See it in action in a ([styled](https://github.com/awaescher/PoshX)) powershell console:



![Screenshot](https://raw.githubusercontent.com/awaescher/RepoZ/master/_doc/grr-5fps-compressed.gif)



#### Don't forget to have a look at `grr help` once you get your hands on.



## Enhanced Windows Explorer Titles

As an extra goodie for Windows users, RepoZ automatically detects open File Explorer windows and adds a status appendix to their title if they are in context of a git repository.



![Screenshot](https://raw.githubusercontent.com/awaescher/RepoZ/master/_doc/RepoZ-ReadMe-Explorer.png)



## Dependencies ⚠︎

Some user [reported crashes at program start](https://github.com/awaescher/RepoZ/issues/83). Please make sure to install the [.NET Framework Runtime v4.7.2](http://go.microsoft.com/fwlink/?LinkId=863262) if you experience similar issues.



## Credits

The **grr** app icon was made by Freepik from www.flaticon.com and is licensed by CC 3.0 BY