GitHub Browse tools

Getting started with ketch

Three steps from nothing to a verified tool on your PATH. ketch is a command-line tool: there is no account to create and nothing to sign up for.

1
Step 1: Install ketch

One script on macOS and Linux. It runs ketch self install and ketch path install, so ketch ends up in ~/.ketch as one of its own packages. Then make sure ~/.ketch/bin is on your PATH — ketch doctor tells you if it is not.
```
curl -fsSL https://raw.githubusercontent.com/pyrlyn/ketch/main/install.sh | bash
```
Windows, Homebrew or mise
```
irm https://raw.githubusercontent.com/pyrlyn/ketch/main/install.ps1 | iex
```
```
brew install --cask pyrlyn/tap/ketch
```
```
mise use -g github:pyrlyn/ketch
```
2
Step 2: Install your first tool

Point ketch at any repository that publishes releases. It picks the asset built for your machine, checks the SHA-256 the release published, and links the binary onto your PATH.
```
ketch install pyrlyn/rtok
```
3
Step 3: See what it did

ketch reports each stage: resolving the package, downloading the asset for your platform, verifying the checksum, and the installed version. The tool is on your PATH straight away.
ketch — install & verify
```
$ ketch install pyrlyn/rtok
resolving   rtok (github:pyrlyn/rtok)
downloading rtok-aarch64-apple-darwin.tar.xz
verified    sha256 published by the release
installed   rtok 0.1.0

$ rtok --version
rtok 0.1.0
```
Example output from the ketch README demo (Apple silicon, rtok 0.1.0). Asset name and version depend on your machine and the latest release.

Where to go next