Install

Three paths. Same rdk command.

Pick the path that fits your setup. All three deliver the same rdk command.

macOS — Homebrew (recommended for Mac)

brew tap thetechjd/rdk
brew install rdk

Requires Homebrew. If you don't have it, install with /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Linux — curl (recommended for Linux)

curl -fsSL https://raw.githubusercontent.com/thetechjd/rdk/main/install.sh | bash

This drops a self-contained rdk binary in /usr/local/bin. Doesn't require Node.js or a compiler.

Any platform — npm

If you have Node.js 20+ installed, this works on macOS, Linux, and Windows:

npm install -g @retrodeck/rdk

The package is scoped under @retrodeck. The installed command is still rdk.

Verify the install

rdk --version

If you see a version number, you're ready. Run rdk init to start the setup wizard.

Reinstall / wipe state

If you need to start fresh:

brew uninstall rdk        # if installed via brew
brew untap thetechjd/rdk  # forget the tap entirely
rm -rf ~/.rdk             # wipe config, vault key, indexed chunks

Then reinstall via your preferred path above.

rm -rf ~/.rdk deletes your config, vault key, and indexed chunks. To keep them, back up first: cp -r ~/.rdk ~/.rdk.bak