Installation

Install koshi on Linux, macOS, or Windows with Homebrew, Scoop, the release script, or from source.

koshi ships prebuilt binaries for Linux, macOS, and Windows on x86-64 and ARM64. Pick one method below.

macOS

With Homebrew:

brew install gohyuhan/koshi/koshi

Homebrew adds the koshi tap during installation. Upgrade koshi along with your other outdated packages:

brew update
brew upgrade

Or upgrade only koshi:

brew upgrade koshi

With the release script:

curl --proto "=https" --tlsv1.2 -sSfL \
  https://github.com/gohyuhan/koshi/releases/latest/download/install.sh | bash

curl --proto "=https" --tlsv1.2 -sSfL \
  https://github.com/gohyuhan/koshi/releases/latest/download/install.sh | bash

With PowerShell:

powershell -c "irm https://github.com/gohyuhan/koshi/releases/latest/download/install.ps1 | iex"

With Scoop:

scoop bucket add koshi https://github.com/gohyuhan/scoop-koshi
scoop install koshi/koshi

Upgrade after refreshing Scoop:

scoop update
scoop update koshi

Building needs Rust 1.96.

git clone https://github.com/gohyuhan/koshi.git
cd koshi
cargo build --release
./target/release/koshi

koshi checks for a newer release at startup and can install it itself:

koshi update

Removing koshi later takes more than deleting the binary — config, logs, cache, and runtime files live outside the install directory. See Uninstall.