Kintsugi runs entirely on your machine. Nothing is hosted, nothing phones home. You install one CLI and use it from any terminal.
Requirements
You need Node.js 20 or newer.
node --version
If that prints anything below v20, install a recent Node from nodejs.org or via a version manager like nvm or mise.
Install the CLI
npm install -g @ophelios/kintsugi-cli
That installs the kintsugi binary globally. Verify:
kintsugi --help
You should see the available commands: rescue, ui, status, revoke.
Install from source
If you prefer to read every line before running it (recommended for a tool that signs transactions on a wallet you've lost control of), clone the repo and link it locally:
git clone https://github.com/ophelios-studio/kintsugi
cd kintsugi
npm install
npm --workspace @ophelios/kintsugi-core run build
npm --workspace @ophelios/kintsugi-cli run build
npm --workspace @ophelios/kintsugi-cli link
kintsugi --help
The link step makes the local kintsugi command available on your PATH the same way a global npm install would.
Update
npm install -g @ophelios/kintsugi-cli@latest
There is no auto-update. Releases are tagged on GitHub.
Uninstall
npm uninstall -g @ophelios/kintsugi-cli
Kintsugi writes nothing to disk, so removing the binary is the only cleanup needed.
Next
Make sure you have what you need before starting a rescue: see Prerequisites.