fuzzy-clone (fz)

, is my alias for fz

Fuzzy clone is a repository picker and downloader. It exists for one purpose, so that you don't have to fiddle around in a git ui (github, gitea, etc.), find a download link, cd on your local pc, git clone, cd again and so on.

Fuzzy clone simply presents a list of your subscribed orgs, and you fuzzy search, hit enter and you're placed in the repo, simply as that.

Install

Golang

go install github.com/kjuulh/fuzzy-clone@latest

Homebrew

brew install kjuulh/brew/fuzzy-clone  

fz

Setup

Setup the utility scripts

Zsh

echo 'eval "$(fuzzy-clone init zsh)" >> ~/.zshrc' 

fz

Usage

fz

# For the fully qualified binaries without shell niceties
fuzzy-clone

# Update cache manually (done automatically in fz)
fuzzy-clone cache update

Configuration

Fuzzy clone either uses

# Home
FUZZY_CLONE_ROOT=$HOME/git # default
# Will produce a structure like so once a repo is cloned
# $HOME/git/github.com/kjuulh/fuzzy-clone

# Authentication
FUZZY_CLONE_GITHUB_TOKEN=#<github token>
# Or fallbacks on
GITHUB_ACCESS_TOKEN=#<github token>

Your github token should have repo:read at least. Consider adding org:read as well if you need access to org repos

Media

• Annoucement: https://blog.kasperhermansen.com/posts/introducing-fuzzy-clone/