From dbf5573c8af133f7bf6dc69f57cb81928046351d Mon Sep 17 00:00:00 2001
From: Thor Ivar Nirisen Johansen <thor.johansen@bouvet.no>
Date: Mon, 22 Jun 2026 22:11:28 +0200
Subject: [PATCH] docs: issue with opti-cli and volta

---
 README.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/README.md b/README.md
index a8c006d..d8cbe47 100644
--- a/README.md
+++ b/README.md
@@ -30,6 +30,12 @@ npm install
 npm run cli:install
 ```
 
+> **Volta users:** Volta does not automatically create a shortcut in `~/.volta/bin` for packages installed with `npm install -g`. After running `cli:install`, run this once to create a shortcut so Volta can find the `opti` command:
+>
+> ```bash
+> ln -sf ~/.volta/tools/image/node/$(node -v | tr -d 'v')/bin/opti ~/.volta/bin/opti
+> ```
+
 ### Usage
 
 In terminal, run `opti` followed by command.