findSkillkitBin() fails to discover skillkit installed via pnpm

[kuleka]

Problem

When @crafter/skillkit is installed globally via pnpm (pnpm install -g @crafter/skillkit), the Agentfiles plugin reports "skillkit not found" in the dashboard's Scan Sessions feature.

This happens because findSkillkitBin() in src/skillkit.ts searches a hardcoded list of directories that does not include pnpm's global binary directory.

Root Cause

The current search paths include:

• /usr/local/bin
• /opt/homebrew/bin
• ~/.local/bin
• ~/.bun/bin
• ~/.nvm/versions/node/*/bin/
• ~/.local/share/mise/installs/{node,bun}/*/bin/

But pnpm installs global binaries to:

• macOS: ~/Library/pnpm/
• Linux: ~/.local/share/pnpm/

These paths are not searched, so the plugin cannot find skillkit.

Why symlinks don't work as a workaround

A natural workaround would be to symlink skillkit into one of the searched directories (e.g., ~/.local/bin/skillkit -> ~/Library/pnpm/skillkit). However, this also fails because the pnpm-generated skillkit shell wrapper uses $0 to compute basedir:

basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")

When invoked via symlink, $0 resolves to the symlink location (e.g., ~/.local/bin), not the actual pnpm directory. This causes all relative paths in the script (e.g., $basedir/global/5/.pnpm/...) to break.

The only working workaround is to create a wrapper script instead of a symlink:

#!/bin/sh
exec ~/Library/pnpm/skillkit "$@"

Suggested Fix

Add pnpm's global bin directories to the search list in findSkillkitBin():

// macOS
path.join(home, "Library", "pnpm"),
// Linux / Windows
path.join(home, ".local", "share", "pnpm"),

Alternatively, you could also detect the pnpm global bin directory dynamically:

try {
  const pnpmBin = execSync("pnpm bin -g", { encoding: "utf-8" }).trim();
  if (pnpmBin) dirs.push(pnpmBin);
} catch {}

Environment

• macOS 15 (Darwin 25.3.0, arm64)
• pnpm 10.33.0
• @crafter/skillkit 0.10.3
• Agentfiles plugin (latest from Obsidian community plugins)

[kuleka]

Happy to submit a PR for this if you'd like — just let me know which approach you prefer (hardcoded pnpm paths or dynamic detection via pnpm bin -g).

[dragthelake]

Same issue with Volta

Volta users hit the same problem. Volta installs global binaries to ~/.volta/bin/, which isn't in the plugin's search paths either.

Workaround: Symlink into a searched directory (unlike pnpm, Volta binaries are real executables so symlinks work fine):

mkdir -p ~/.local/bin
ln -s ~/.volta/bin/skillkit ~/.local/bin/skillkit

Suggested fix: Add ~/.volta/bin to findSkillkitBin():

path.join(home, ".volta", "bin"),

Environment:

• macOS 15 (Darwin 25.4.0, arm64)
• Volta (node 22.x)
• @crafter/skillkit 0.10.4
• Agentfiles 0.5.0

[Railly]

Go for it @kuleka! The approach I'd suggest:

1. Static paths first for pnpm, volta, yarn, fnm, asdf, and proto. Both findSkillkitBin() and buildPath() need the same additions.
2. Dynamic fallback (pnpm bin -g, yarn global bin) only when static misses, so the common case stays zero-cost.

Make sure to mirror the additions in both functions, since buildPath() is used for PATH when executing skillkit commands, so dependencies resolve correctly.

Happy to review the PR when it's ready.