Install Kosh

Kosh can be installed in three ways:

Download a prebuilt binary (easiest)
Using go install
Building from source

Download Prebuilt Binary (Easiest)

Prebuilt binaries are available for macOS, Linux, and Windows.

Visit the releases page: available via Github for now github.com/gitKashish/kosh/releases
Download the appropriate file for your platform, e.g.:
- kosh-vX.Y.Z-darwin-arm64 (macOS Apple Silicon)
- kosh-vX.Y.Z-darwin-amd64 (macOS Intel)
- kosh-vX.Y.Z-linux-amd64 (Linux x86_64)
- kosh-vX.Y.Z-linux-arm64 (Linux ARM)
- kosh-vX.Y.Z-windows-amd64.exe (Windows)
Make it executable (macOS/Linux):
Terminal window
```
chmod +x kosh-*
```
Move it somewhere in your PATH, for example:
Terminal window
```
sudo mv kosh-* /usr/local/bin/kosh
```

Using Go Install (Recommended for Go Users)

The quickest way to install Kosh is:

go install github.com/gitKashish/kosh@latest

This installs the kosh binary into your Go bin directory (usually ~/go/bin). Make sure this directory is part of your PATH:

export PATH="$PATH:$(go env GOPATH)/bin"

Install from Source

If you want to build Kosh manually or modify the code:

git clone https://git.plutolab.org/plutolab/kosh.git
cd kosh
go build

This will produce a kosh binary in the project root for your current platform.

Verify Installation

Run:

kosh help

If the installation was successful, you should see:

kosh help                 Show help and usage
kosh init                 Initialize a new encrypted vault
kosh add                  Add or update a credential
kosh list                 List credentials
kosh get <label> <user>   Retrieve a credential
kosh search <query>       Adaptive fuzzy search
kosh delete <id>          Delete a credential

Kosh is now ready to use!