Scripting and shell integration

Jump into a repositoryCopy Anchor Link

-p or --print-path changes what enter does. The action menu is skipped: enter on a repository picks it, clones it first when it is not on disk, and prints its absolute path on stdout. Everything else, including the screen and git's progress, goes to stderr.

cd "$(gh select -p)"

A shell function that does not cd when you quit without picking:

ghcd() {
  local dir
  dir=$(gh select --print-path) && cd "$dir"
}

Quitting without a pick exits with status 130, so the && stops and cd "" never runs.

Combine it with a clone root so new clones land in one place:

GH_SELECT_CLONE_DIR=~/dev gh select -p

Refresh the cache on a scheduleCopy Anchor Link

gh select refresh fetches every repository you can access, saves the cache and prints the count. It never opens the screen, so it suits cron and timers.

gh select refresh

Refreshed 312 repositories

*/30 * * * * gh select refresh >/dev/null 2>&1

Other commands, doctor, limits, version and help, also run once and exit.

Checking a version in a scriptCopy Anchor Link

gh select version

gh-select v2.6.0

A newer release, when the last daily check found one, is named on stderr, so $(gh select version) still captures only the version line. A local build prints dev+COMMIT, with -dirty when the tree had uncommitted changes.

Exit codesCopy Anchor Link

See exit codes for details.

Plain outputCopy Anchor Link

Help and error output is colored only when stderr or stdout is a terminal. Set NO_COLOR to any value to turn color off.