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: Kosh Release Page
Download the appropriate file for your platform, e.g.:
- kosh_Darwin_arm64.tar.gz (macOS Apple Silicon)
- kosh_Darwin_x86_64.tar.gz (macOS Intel)
- kosh_Linux_arm64.tar.gz (Linux ARM)
- kosh_Linux_i386.tar.gz (Linux 32-bit x86)
- kosh_Linux_x86_64.tar.gz (Linux AMD64)
- kosh_Windows_i386.zip (Windows 32-bit x86)
- kosh_Windows_x86_64.zip (Windows AMD64)
Extract the executable from the archive.
Make it executable (macOS/Linux only):
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 git.plutolab.org/plutolab/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 - Secure Password Manager

Usage:
kosh add - add a new credential to vault
kosh delete <credential_id> - delete a stored credential.
kosh generate [options] <label> <user> - generate a strong password and store as credential
kosh get <label> <user> - retrieve a stored credential
kosh list [--label <label>] [--user <user>] - list all credentials associated to a label or user
kosh search <label> <user> - fuzzy search a credential and copy the best match.
kosh update <id> - update existing credential
kosh help - show help information
kosh init - initialize vault with master password.

For more information, visit: https://git.plutolab.org/plutolab/kosh

Kosh is now ready to use!