Skip to content

hop

hop turns one hop.yaml config into a personal directory of all your git repos — fuzzy-navigate to any of them, clone the ones you’re missing, and run a command (or batch-update) across the whole set from anywhere on your machine. For developers juggling many repositories at once, hop replaces a tangle of cd and git commands with one map of everywhere you work.

Terminal window
curl -fsSL https://shll.ai/install | sh -s -- hop

Installs shll + hop via Homebrew — or install the whole toolkit.

Two more commands finish the setup — hop’s headline job (cd-ing your shell) needs the shell shim, and its config is built from your existing clones:

Terminal window
shll shell-setup # wire the shell shim, then open a fresh terminal
hop add -r ~/code # walk your code dir, build hop.yaml from git remotes

The install guide walks through every step, from-source installs included.

hop is the cross-cutting navigator: it gets you into any repo fast, where you can capture a backlog item with idea or spin up an isolated wt worktree to start a change. It’s the layer above individual repos.

  • Readme — the full canonical guide, synced from hop’s own repo.
  • Commands — every subcommand and flag.