zhanj/claude-hud
1
0
Fork 0
mirror of https://github.com/jarrodwatts/claude-hud.git synced 2026-04-16 06:32:39 +00:00
Code Issues Packages Projects Releases Wiki Activity

fix: detect EXDEV cross-device error on Linux installation (#53)

Browse Source 
* fix: detect EXDEV cross-device error on Linux installation

When plugin path is not found during setup on Linux, check if /tmp and
~/.claude are on different filesystems. If so, provide the TMPDIR
workaround to users.

Fixes #52

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Jarrod Watts
2026-01-08 21:23:50 +11:00
committed by GitHub
parent 588429909e
commit 4bf43b01f7
1 changed files with 9 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

10
commands/setup.md
View File

@@ -15,7 +15,15 @@ allowed-tools: Bash, Read, Edit, AskUserQuestion
```bash
ls -td ~/.claude/plugins/cache/claude-hud/claude-hud/*/ 2>/dev/null | head -1
```
If empty, the plugin is not installed. Tell user to install via marketplace first.
If empty, the plugin is not installed. **On Linux only** (if `uname -s` returns "Linux"), check for cross-device filesystem issue:
```bash
[ "$(df --output=source ~/.claude /tmp 2>/dev/null | tail -2 | uniq | wc -l)" = "2" ] && echo "CROSS_DEVICE"
```
If this outputs `CROSS_DEVICE`, explain that `/tmp` and `~/.claude` are on different filesystems, which causes `EXDEV: cross-device link not permitted` during installation. Provide the fix:
```bash
mkdir -p ~/.cache/tmp && TMPDIR=~/.cache/tmp /plugin install claude-hud
```
After they run this, re-check the plugin path and continue setup. For non-Linux systems (macOS, etc.), simply tell user to install via marketplace first.
2. Get runtime absolute path (prefer bun for performance, fallback to node):
```bash