afwf_github 1.0.3

Alfred GitHub Workflow.

---

Welcome to afwf_github Documentation

It is an Alfred Workflow for GitHub operations. There already is a PHP alfred-github-workflow library for this. But the searching is based on Alfred built-in word level filtering, which doesn’t allow any typo, fuzzy, and full text search. This project aims to provide the best searching experience powered by tantivy (via sayt2), a Rust-based full-text search engine.

Install

1. Make sure you have Alfred 5 + installed and bought the Power Pack.

2. Go to Release, download the latest release.

3. Double click the file to install.

4. Prepare your GitHub Personal Access Token: go to https://github.com/settings/tokens, create a new token, make sure you checked repo -> public_repo, admin:org -> read:org, admin:enterprise -> read:enterprise so the workflow can get your public repo name and url information. If you want to get your private repo as well, you should check repo (Full control of private repositories).

Usage

1. Configuration.

   In Alfred UI, type gh-config, it should open the ~/.alfred-afwf/afwf_github/config.json``

   

2. Build Index

   In Alfred UI, type gh-rebuild-index, it should start to crawl your GitHub repos. It will take a while to finish. You can check the progress in the ~/.alfred-afwf/afwf_github/.repo_index/

   

3. Search GitHub

   In Alfred UI, type gh ${query}, it should show the following UI:

   

4. Open Git Repo in Browser

   Copy any absolute path of a file in any git repo, type gh-view-in-browser ${path} then hit Enter, it should open the repo in browser.

   

Trouble Shooting

1. gh ${query} doesn’t show any result.

   Check the ${HOME}/.alfred-afwf/afwf_github/ folder, if there’s no folder name equal to your github username(where to store the index), it means the Workflow failed to crawl your GitHub repos. Please double check ${HOME}/.alfred-afwf/afwf_github/config.json to make sure you have the correct GitHub Personal Access Token.