Shell Integration¶

Shell aliases¶

The simplest way to keep your existing muscle memory. Add to your .zshrc or .bashrc:

1
2
3
4
5

alias gco='twig goto'
alias gdo='twig save'
alias gp='twig push'
alias grt='twig root'
alias gprune='twig prune'

twig also has built-in short aliases (twig g, twig s etc.) if you prefer not to define shell aliases.

twig root — changing directory¶

twig root prints the repo root path but cannot change your shell's working directory — that requires a shell function:

1
2
3

grt() {
  cd "$(twig root)"
}

Passthrough — using twig as a git replacement¶

With passthrough.enabled = true, any subcommand twig doesn't recognise is forwarded to git verbatim:

1
2
3

[passthrough]
enabled     = true
prefer_twig = true    # twig subcommands win on name conflict

Then alias git to twig in your shell:

1

alias git=twig

Now everything works transparently:

1
2
3
4
5

git rebase -i HEAD~3    # → forwarded to git
git stash               # → forwarded to git
git log --oneline       # → forwarded to git
twig save               # → handled by twig
git save                # → also handled by twig (alias resolves to twig)

Windows (Git Bash)¶

The same aliases and shell functions work in Git Bash — paste them into ~/.bashrc. See the Windows guide for full setup.