https://github.com/sheepla/gh-fzrepo

🚀 An extension for GitHub CLI to browse repositories with fzf
https://github.com/sheepla/gh-fzrepo

bash cli fzf-scripts gh-extension github-api github-cli

Last synced: about 2 months ago
JSON representation

🚀 An extension for GitHub CLI to browse repositories with fzf

• Host: GitHub
• URL: https://github.com/sheepla/gh-fzrepo
• Owner: sheepla
• License: mit
• Archived: true
• Created: 2021-09-11T05:49:32.000Z (about 3 years ago)
• Default Branch: master
• Last Pushed: 2022-02-09T14:00:22.000Z (over 2 years ago)
• Last Synced: 2024-06-22T09:40:04.002Z (3 months ago)
• Topics: bash, cli, fzf-scripts, gh-extension, github-api, github-cli
• Language: Shell
• Homepage:
• Size: 16.6 KB
• Stars: 25
• Watchers: 1
• Forks: 1
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-gh-cli-extensions - **fzrepo** - Extension for GitHub CLI to browse repositories with fzf. (Tool)
• jimsghstars - sheepla/gh-fzrepo - 🚀 An extension for GitHub CLI to browse repositories with fzf (Shell)

README

        
# 🚀 gh-fzrepo



    

    



An extension for [GitHub CLI](https://github.com/cli/cli) to browse repositories with fzf

## Demo on asciinema.org

> [https://asciinema.org/a/435075](https://asciinema.org/a/435075)

[![asciicast](https://asciinema.org/a/435075.svg)](https://asciinema.org/a/435075)

## Features

- [x] Quickly browse the README of each repository

- [x] Open URL of the repository in your default browser immediately

## Usage

```

gh fzrepo -- An extension for GitHub CLI to browse repositories with fzf

USAGE

    gh fzrepo KEYWORDS...

    gh fzrepo -h|--help

    gh fzrepo -V|--version

```

### Keybindings

| key | function |

|-----|----------|

| `Ctrl+J`, `Ctrl+N` | move focus down |

| `Ctrl+K`, `Ctrl+P` | move focus up |

| `Enter` | view README with `gh repo view` |

| `Ctrl+O` | open URL of the repository in your default browser | 

| `Esc`, `q` | quit fzf | 

## Installation

Dependences:

- [GitHub CLI](https://github.com/cli/cli) v2.0.0+

- [junegunn/fzf](https://github.com/junegunn/fzf)

```bash

gh extension install sheepla/gh-fzrepo

```

## One Liner Edition

```bash

query="..."; gh api "search/repositories?q=${query}" --jq ".items[].full_name" | fzf --preview "gh repo view {}" --bind "enter:execute(gh repo view {})" --bind "ctrl-o:execute(gh repo view -w {})"

```

## Contribution

Welcome!