Skip to content

Install

Requirements

  • git installed and on your PATH
  • macOS 12+, Linux (amd64/arm64), or Windows via Git Bash

twig has no other runtime dependencies. The interactive TUI is built in — no fzf or external picker needed.

macOS

1
2
brew tap anadinema/tap
brew install twig

To upgrade:

1
brew upgrade twig

Linux

Install script

1
curl --proto '=https' --tlsv1.2 -sSf https://twig.anadinema.dev/install.sh | bash -s -- --to ~/.local/bin

The script detects your architecture and installs the binary to the path specified by --to. Make sure that directory is on your PATH.

Manual

Download the binary for your architecture from the releases page, make it executable, and move it to somewhere on your PATH.

1
2
3
4
# Example for linux/amd64
curl -Lo twig https://github.com/anadinema/twig/releases/latest/download/twig_linux_amd64
chmod +x twig
mv twig ~/.local/bin/twig

Windows (Git Bash)

twig works best inside Git Bash using the linux_amd64 binary. This gives full TUI support without Windows terminal compatibility concerns.

  1. Download twig_linux_amd64 from the latest release
  2. Place it in ~/bin (Git Bash adds this to PATH automatically)
  3. Rename and make executable:
1
2
3
mkdir -p ~/bin
mv ~/Downloads/twig_linux_amd64 ~/bin/twig
chmod +x ~/bin/twig

See the Windows guide for full setup including shell aliases.

Verify

1
twig --version

Next steps