Install

Install with Go

go install github.com/yupsh/repl/yupsh@latest

This installs a yupsh binary to $GOPATH/bin (or $HOME/go/bin if GOPATH isn't set). Make sure that directory is on your PATH.

Start the shell

yupsh

You should see a banner and the yup> prompt. On a TTY you get history and in-line editing via golang.org/x/term; piped input uses plain line scanning instead, so scripts stay deterministic.

Run your first pipeline

yup> echo hello world
hello world
yup> seq 1 10 | grep -v 5 | head -n 3
1
2
3

If that printed 1, 2, 3, the install worked.

Optional: run a script non-interactively

yupsh < script.txt

Useful for CI or repeatable pipelines — piped input always uses the plain scanning path, so there's no TTY-dependent behavior to account for.

Next: Usage covers the input model and shell expansion rules in full.