From 293fe52056b41aab240b1112935108e354c11048 Mon Sep 17 00:00:00 2001
From: petebytes <pete@apsion.com>
Date: Wed, 10 Sep 2025 15:19:24 -0500
Subject: [PATCH] docs: Add claude PATH troubleshooting section

Fixes 'claude not found' error when Claude is installed but
uvx cannot find it in PATH during subprocess execution.
---
 docs/installation.md | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/docs/installation.md b/docs/installation.md
index b1cd7b018..30e2bb4de 100644
--- a/docs/installation.md
+++ b/docs/installation.md
@@ -51,6 +51,20 @@ After initialization, you should see the following commands available in your AI
 
 ## Troubleshooting
 
+### Claude CLI Not Found Error
+
+If you have Claude installed but see `⚠️  claude not found`, the installation cannot find the `claude` command in PATH.
+
+**Quick fix:**
+```bash
+PATH="$HOME/.claude/local:$PATH" uvx --from git+https://github.com/github/spec-kit.git specify init --here
+```
+
+**Other solutions:**
+- Find claude location: `which claude`
+- Add to shell permanently: `export PATH="$HOME/.claude/local:$PATH"` in `~/.bashrc`/`~/.zshrc`
+- Create symlink: `ln -s ~/.claude/local/claude /usr/local/bin/claude`
+
 ### Git Credential Manager on Linux
 
 If you're having issues with Git authentication on Linux, you can install Git Credential Manager: