Skip to content

liouk/glone

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

glone

A TUI for browsing, cloning, and opening GitHub repos from your orgs.

Built with Bubble Tea.

Install

go install github.com/liouk/glone@latest

Requires:

  • Go 1.25+
  • gh CLI (authenticated)

Config

Create ~/.config/glone/config.yaml:

editor: code                             # optional; auto-opens repos after clone
orgs:
  - name: my-company
    clone_dir: ~/src/my-company          # repos clone to ~/src/my-company/<repo>
    exclude:                             # hide repos from the list
      - .github
      - old-project
  - name: my-username
    clone_dir: ~/src/personal            # original repos → ~/src/personal/<repo>
    fork_clone_dirs:                     # forks routed by parent org:
      my-company: ~/src/my-company-forks #   company forks → ~/src/my-company-forks/<repo>
                                         #   other forks → ~/src/personal/<repo> (default)
Field Required Description
editor no Editor binary to open repos in after clone
orgs[].name yes GitHub org or username
orgs[].clone_dir yes Directory to clone repos into (<clone_dir>/<repo>)
orgs[].fork_clone_dirs no Map of parent org → clone dir for forked repos
orgs[].exclude no List of repo names to hide from the list

Usage

glone

If multiple orgs are configured, you'll first pick one (press 1-9/0 to quick-select). Then browse repos with fuzzy filtering.

Keybindings

Key Action
type Fuzzy filter repos
enter Clone repo (or open if already cloned)
ctrl+s Shallow clone (--depth 1)
ctrl+f Fork repo, clone the fork, and open
ctrl+o Open in browser
esc / ctrl+c Quit

Already-cloned repos are marked with ✓ and enter opens them in the configured editor. After cloning, the repo auto-opens in the editor if configured; otherwise the path is printed to stdout.

ctrl+f forks the selected repo under your GitHub user, clones the fork (using fork_clone_dirs to pick the destination), and opens it. Requires a matching org entry in your config for your GitHub username.

Shell integration

glone prints the repo path to stdout on success, so you can:

cd "$(glone)"

About

Quickly browse and clone github repos

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages