https://github.com/aead/isgit
CLI tool that filters and outputs paths to git repositories
https://github.com/aead/isgit
cli find fzf git go
Last synced: 15 days ago
JSON representation
CLI tool that filters and outputs paths to git repositories
- Host: GitHub
- URL: https://github.com/aead/isgit
- Owner: aead
- License: mit
- Created: 2020-10-12T09:45:59.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2020-10-12T11:49:09.000Z (over 5 years ago)
- Last Synced: 2025-01-21T20:48:26.308Z (over 1 year ago)
- Topics: cli, find, fzf, git, go
- Language: Go
- Homepage:
- Size: 149 KB
- Stars: 1
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## isgit(1)
`isgit` is a small command-line tool that consumes a list of file paths and outputs all paths
that point to a git repository.
```
Usage:
isgit [-o OUTPUT] [PATH ...]
Options:
-o, --output OUTPUT Write the result to the file at path OUTPUT.
isgit iterates over all PATH arguments and writes any PATH that
points to a git repository (containing a '.git' subdirectory) to
OUTPUT.
isgit reads a list of file paths from standard input if no PATH
argument(s) have been provided or when one PATH is '-'.
OUTPUT defaults to standard output.
```
### Example
Filter all paths that are git repositories:
```sh
isgit $HOME/project $HOME/my-repo
```
Find all git repositories under `$HOME` using [`fd`](https://github.com/sharkdp/fd) or GNU `find`:
```sh
fd -HL -t d "." "$HOME" | isgit
```
```sh
find -L "$HOME" -type d | isgit
```
> The output of both commands may differ because `fd` honors ignore files. See `fd --help`
Fuzzy-search all git repositories under `$HOME` using [`fzf`](https://github.com/junegunn/fzf)
and [`fd`](https://github.com/sharkdp/fd) and show a commit history preview:
```sh
fd -H -L -t d "." "$HOME" | isgit | fzf \
--height 100% --reverse --border --preview-window right:50% \
--preview 'git -C {} log --color=always --pretty=oneline --abbrev-commit'
```
### Install
#### Binary Releases
| OS | Arch | Binary |
|---------|-------|-----------------------------------------------------------------------------------------------------------|
| Linux | amd64 | [isgit-linux-amd64](https://github.com/aead/isgit/releases/latest/download/isgit-linux-amd64) |
| MacOS | amd64 | [isgit-darwin-amd64](https://github.com/aead/isgit/releases/latest/download/isgit-darwin-amd64) |
| Windows | amd64 | [isgit-windows-amd64.exe](https://github.com/aead/isgit/releases/latest/download/isgit-windows-amd64.exe) |
| FreeBSD | amd64 | [isgit-freebsd-amd64](https://github.com/aead/isgit/releases/latest/download/isgit-freebsd-amd64) |
| | | |
| Linux | arm | [isgit-linux-arm](https://github.com/aead/isgit/releases/latest/download/isgit-linux-arm) |
| Linux | arm64 | [isgit-linux-arm64](https://github.com/aead/isgit/releases/latest/download/isgit-linux-arm64) |
#### Download via cURL
| OS | Arch | cURL Command |
|---------|-------|------------------------------------------------------------------------------------------------------------------|
| Linux | amd64 | `curl -SL --tlsv1.2 -o isgit https://github.com/aead/isgit/releases/latest/download/isgit-linux-amd64` |
| MacOS | amd64 | `curl -SL --tlsv1.2 -o isgit https://github.com/aead/isgit/releases/latest/download/isgit-darwin-amd64` |
| Windows | amd64 | `curl -SL --tlsv1.2 -o isgit.exe https://github.com/aead/isgit/releases/latest/download/isgit-windows-amd64.exe` |
| FreeBSD | amd64 | `curl -SL --tlsv1.2 -o isgit https://github.com/aead/isgit/releases/latest/download/isgit-freebsd-amd64` |
| | | |
| Linux | arm | `curl -SL --tlsv1.2 -o isgit https://github.com/aead/isgit/releases/latest/download/isgit-linux-arm` |
| Linux | arm64 | `curl -SL --tlsv1.2 -o isgit https://github.com/aead/isgit/releases/latest/download/isgit-linux-arm64` |
#### From Source
```sh
go get github.com/aead/isgit
```
### License
Use of `isgit` is governed by the MIT license that can be found in the LICENSE file.