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.

Gitnow is a slightly more robust tool, by @kjuulh as well, https://github.com/kjuulh/gitnow, it features the same toolset, but allows for more expansive configuration

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

Config file

Fuzzy clone supports setting options via. a config file as well. ~/.config/fz/config.toml

An example file can be generated using: fuzzy-clone init config --write, without the --write flag it will just write it to stdout

All options are documented in the example output

Media

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