yank-run-cli

yank-run-cli

Command-line client for yank.run — search, store, and run code snippets without leaving your terminal.

yank search vault kubectl     # find a snippet
yank show 0                   # eyeball the first result
yank cat 0 | bash             # run it

Install

With Go:

go install github.com/korotinm/yank-run-cli/cmd/yank@latest

The binary is installed as yank into $(go env GOPATH)/bin — make sure that directory is on your PATH.

From source:

git clone https://github.com/korotinm/yank-run-cli
cd yank-run-cli
make install            # → $(go env GOPATH)/bin/yank
# or just build locally:
make build              # → ./bin/yank

Quick start

# Store a snippet (body from -b, -f, or piped stdin)
yank push -b 'kubectl get pods -A' -t "List pods" --tag k8s

# Search, then act on a result by its index
yank search vault kubectl
yank show 0                     # human-readable view of the first hit
yank cat 0 | bash               # print its body and run it
yank copy 0                     # put its body on the clipboard
yank open 0                     # open it in the browser

Commands

Run yank <command> --help for the full flag list of any command.

Snippet references

Commands that operate on a single snippet (cat, show, copy, open) accept a REF that is either:

• a 64-char hex id, or
• a 0-based index into the results of your last yank search.

yank search remembers its results, so yank cat 0 refers to the first hit, yank show 2 to the third, and so on — until the next search.

Output conventions

The CLI is built for shell pipelines:

• stdout carries data only (snippet body, search rows, ids).
• stderr carries everything else (hints, errors, progress).
• Colors appear only on an interactive terminal, and are disabled by --no-color or the NO_COLOR environment variable.
• --json is available on push, show, and search for scripting.

yank search kubectl | fzf | awk '{print $1}' | xargs yank cat
yank cat <id> > script.sh

Configuration

CLI flags (--url, --timeout, --json, --no-color) always override the environment.

Exit codes

Development

make build              # local ./bin/yank
make cross              # cross-compiled binaries in ./dist
make vet                # go vet
make fmt                # gofmt -s

yank --version reports the build version, embedded at compile time.

License

MIT © Mikhail Korotin