From efd867afb97c9f1cf33f5a4572611193d6786086 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Sun, 10 May 2026 12:01:03 +0000
Subject: [PATCH 1/2] =?UTF-8?q?docs:=20clarify=20source=20install=20?=
 =?UTF-8?q?=E2=80=94=20pipx=20for=20global,=20poetry=20shell=20for=20venv?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

https://claude.ai/code/session_0112ftTonVeWk5AXsuvjPXph
---
 README.md | 21 +++++++++++++++++++--
 1 file changed, 19 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 4cef14b..11ff784 100644
--- a/README.md
+++ b/README.md
@@ -87,13 +87,30 @@ pip install devha
 docker run --rm -it ghcr.io/waldex451/devha:latest --help
 ```
 
-### From source
+### From source — globally available (`devha` command everywhere)
+
+```bash
+git clone https://github.com/waldex451/devha.git
+cd devha
+
+# Install pipx if you don't have it yet:
+# macOS:  brew install pipx && pipx ensurepath
+# Linux:  pip install pipx && pipx ensurepath
+# Windows: pip install pipx
+
+pipx install .   # installs devha globally — type devha anywhere!
+```
+
+### From source — only inside this project (virtualenv)
 
 ```bash
 git clone https://github.com/waldex451/devha.git
 cd devha
 poetry install
-poetry run devha --help
+
+poetry run devha --help   # prefix every command with "poetry run"
+# OR activate the venv once:
+poetry shell              # now just type: devha --help
 ```
 
 > **Requirements:** Python 3.10+ · Works on Linux, macOS, Windows · `wifi` command requires OS-specific tools (`iwlist`, `nmcli`, `airport`, or `netsh`)

From b4ecea7cc7016f24a4618ae68ed1f1ac28a0f76f Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Sun, 10 May 2026 12:09:49 +0000
Subject: [PATCH 2/2] docs: clean up From source install section to match
 original

https://claude.ai/code/session_0112ftTonVeWk5AXsuvjPXph
---
 README.md | 25 ++++++-------------------
 1 file changed, 6 insertions(+), 19 deletions(-)

diff --git a/README.md b/README.md
index 11ff784..2959017 100644
--- a/README.md
+++ b/README.md
@@ -87,32 +87,19 @@ pip install devha
 docker run --rm -it ghcr.io/waldex451/devha:latest --help
 ```
 
-### From source — globally available (`devha` command everywhere)
-
-```bash
-git clone https://github.com/waldex451/devha.git
-cd devha
-
-# Install pipx if you don't have it yet:
-# macOS:  brew install pipx && pipx ensurepath
-# Linux:  pip install pipx && pipx ensurepath
-# Windows: pip install pipx
-
-pipx install .   # installs devha globally — type devha anywhere!
-```
-
-### From source — only inside this project (virtualenv)
+### From source
 
 ```bash
 git clone https://github.com/waldex451/devha.git
 cd devha
 poetry install
-
-poetry run devha --help   # prefix every command with "poetry run"
-# OR activate the venv once:
-poetry shell              # now just type: devha --help
+poetry run devha --help
 ```
 
+> 💡 **Tip — want to type `devha` anywhere in your terminal?**
+> Run `pipx install .` instead of `poetry install`. pipx installs it globally, isolated from your system Python.
+> macOS: `brew install pipx && pipx ensurepath` · Linux/Windows: `pip install pipx && pipx ensurepath`
+
 > **Requirements:** Python 3.10+ · Works on Linux, macOS, Windows · `wifi` command requires OS-specific tools (`iwlist`, `nmcli`, `airport`, or `netsh`)
 
 ---