fix(install): explain how to add ravel to PATH

Warn after Unix and PowerShell installs when the destination is not discoverable. Document PATH requirements and the direct checkout command for installing the Codex skill.

Author: 12ya

README.md

@@ -32,12 +32,16 @@ Install the latest checksum-verified release on macOS or Linux:
 curl -fsSL https://raw.githubusercontent.com/12vault/ravel/main/install.sh | sh
 ```
 
+The installer writes to `~/.local/bin` by default. If that directory is not on `PATH`, it prints the exact command to enable it. Run that command before using `ravel`, then add it to your shell profile so future terminals can find the binary.
+
 On Windows PowerShell:
 
 ```powershell
 irm https://raw.githubusercontent.com/12vault/ravel/main/install.ps1 | iex
 ```
 
+PowerShell prints the equivalent `PATH` command when `~/.local/bin` is not already available.
+
 Release archives also contain a portable `ravel` binary that can run in place without installation. To build from source, install Go 1.26.5 or newer and clone the repository:
 
 ```sh
@@ -46,6 +50,12 @@ cd ravel
 go install ./cmd/ravel
 ```
 
+`go install` writes to `GOBIN`, or to `$(go env GOPATH)/bin` when `GOBIN` is unset. Make sure that directory is on `PATH`. To install the project-local Codex skill straight from this checkout without installing a global binary, run:
+
+```sh
+go run ./cmd/ravel install --project --platform codex
+```
+
 Register the bundled skill with your AI coding assistant:
 
 ```sh

install.ps1

@@ -21,6 +21,13 @@ try {
   New-Item -ItemType Directory -Force -Path $installDir | Out-Null
   Copy-Item (Join-Path $tmp "ravel.exe") (Join-Path $installDir "ravel.exe") -Force
   Write-Output "Installed ravel to $installDir\ravel.exe"
+  $pathEntries = $env:Path -split [IO.Path]::PathSeparator
+  if ($pathEntries -notcontains $installDir) {
+    Write-Warning "$installDir is not on PATH."
+    Write-Output "Run this now:"
+    Write-Output ('  $env:Path = "{0};$env:Path"' -f $installDir)
+    Write-Output 'Then add the same line to your PowerShell profile and open a new terminal.'
+  }
 } finally {
   Remove-Item $tmp -Recurse -Force -ErrorAction SilentlyContinue
 }

install.sh

@@ -32,3 +32,19 @@ tar -xzf "$tmp/$asset" -C "$tmp" ravel
 mkdir -p "$install_dir"
 install -m 0755 "$tmp/ravel" "$install_dir/ravel"
 echo "Installed ravel to $install_dir/ravel"
+
+case ":${PATH:-}:" in
+  *":$install_dir:"*) ;;
+  *)
+    echo ""
+    echo "ravel: $install_dir is not on PATH." >&2
+    echo "Run this now:" >&2
+    printf '  export PATH="%s:$PATH"\n' "$install_dir" >&2
+    case "${SHELL:-}" in
+      */zsh) profile="$HOME/.zshrc" ;;
+      */bash) profile="$HOME/.bashrc" ;;
+      *) profile="your shell profile" ;;
+    esac
+    echo "Then add the same line to $profile and open a new terminal." >&2
+    ;;
+esac