bash-smart-approve:install

Install bash-smart-approve

Wire the plugin into Claude Code settings, create an initial config, and (optionally) import existing permission rules.

Step 1 — Preflight

Run shfmt --version via Bash.

• ✅ Installed → continue.
• ❌ Missing → tell the user the install command for their OS and stop:
  • macOS: brew install shfmt
  • Linux (Debian/Ubuntu): sudo apt install shfmt
  • Linux (Fedora): sudo dnf install shfmt
  • Windows: scoop install shfmt or choco install shfmt

Also confirm node --version ≥ 18.

Step 2 — Locate the plugin & determine install mode

Resolve the plugin root directory and pick one of two install modes:

• Marketplace install — $CLAUDE_PLUGIN_ROOT is set (plugin came from /plugin install). The plugin's own hooks/hooks.json is auto-registered by Claude Code; skip Step 3 entirely. Verify $CLAUDE_PLUGIN_ROOT/hooks/approve.js exists, then continue at Step 4.
• Local / manual install — $CLAUDE_PLUGIN_ROOT is unset. Ask the user: "Where did you clone this repo?" Default suggestion: ~/dev/claude-code-bash-smart-approve. Verify hooks/approve.js exists. Proceed to Step 3 to wire the hook manually.

Step 3 — Wire the hook into ~/.claude/settings.json (manual install only)

Skip this step if $CLAUDE_PLUGIN_ROOT was set in Step 2 — adding a second hook registration would fire the hook twice per Bash call.

Use the update-config skill (or direct Read + Edit) to add this hook to ~/.claude/settings.json, merging with any existing hooks.PreToolUse array:

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "node \"<plugin-root>/hooks/approve.js\"",
            "timeout": 5
          }
        ]
      }
    ]
  }
}

Use the absolute plugin path resolved in Step 2. On Windows, prefer forward slashes or %USERPROFILE% — both are accepted by Node.

Check for duplicates: if a hook already points at this approve.js, skip (don't add twice).