hookstack-cli 0.1.5 → 0.1.7

package/README.md

@@ -0,0 +1,95 @@
+# hookstack-cli
+
+**Install Claude Code hooks in one command.**
+
+[hookstack.vercel.app](https://hookstack.vercel.app) — browse 66+ community-vetted lifecycle hooks for Claude Code & GitHub Copilot, then run this CLI to wire them into your project.
+
+---
+
+## Quick start
+
+```bash
+npx hookstack-cli@latest install --hooks=secret-detection,destructive-command-guard
+```
+
+That's it. The CLI fetches the hooks, shows you what will be installed, and patches your `.claude/settings.json`.
+
+---
+
+## Usage
+
+```
+npx hookstack-cli@latest install --hooks=<slug1>,<slug2>,...
+
+Options:
+  --hooks <slugs>   Comma-separated hook slugs (required)
+  --global, -g      Install into ~/.claude instead of ./.claude
+  --scope <s>       "project" (default) or "global"
+  --yes, -y         Skip prompts (non-interactive / CI)
+  --version, -v     Print version
+  --help, -h        Show help
+```
+
+### Interactive mode (default in a terminal)
+
+When run in a terminal the CLI opens an interactive prompt:
+
+1. Fetches the requested hooks from the registry
+2. Shows an **installation summary** (path, category, events, blocking flag)
+3. Shows a **security panel** (shell access · network · filesystem writes · Snyk score)
+4. Asks for confirmation before writing anything
+
+### Non-interactive mode (`--yes` or piped)
+
+Skips all prompts — useful in CI or dotfile bootstrap scripts.
+
+```bash
+# CI bootstrap
+npx hookstack-cli@latest install --hooks=secret-detection,git-push-guard --yes --scope=project
+```
+
+---
+
+## What gets installed
+
+For each hook the CLI:
+
+- Writes the `.mjs` script to `.claude/hooks/` (or `~/.claude/hooks/` for global scope)
+- Patches `.claude/settings.json` to register the hook on the right lifecycle event
+
+No new dependencies are added to your project. Hooks are plain Node.js scripts — no SDK, no agent modification.
+
+---
+
+## Finding hooks
+
+Browse and filter the full catalogue at **[hookstack.vercel.app](https://hookstack.vercel.app)**:
+
+- Filter by category (`security`, `workflow`, `context`, `validation`…)
+- Select the hooks you want — your basket persists in the browser
+- Copy the generated `npx hookstack-cli@latest install` command and run it
+
+### Popular hooks
+
+| Slug | Event | What it does |
+|---|---|---|
+| `secret-detection` | `PreToolUse / Bash` | Blocks commands that would leak API keys |
+| `destructive-command-guard` | `PreToolUse / Bash` | Stops `rm -rf /`, `DROP TABLE`, and similar |
+| `sensitive-file-protection` | `PreToolUse / Write` | Keeps `.env` and key files untouched |
+| `git-push-guard` | `PreToolUse / Bash` | No accidental push straight to `main` |
+| `git-context-on-startup` | `SessionStart` | Every session opens with branch + status |
+| `auto-format-on-save` | `PostToolUse / Write` | ESLint + Prettier run after every file write |
+| `slack-notify-on-stop` | `Stop` | Pings you when the long task finishes |
+
+---
+
+## Requirements
+
+- Node.js ≥ 18
+- Claude Code installed (hooks are wired into its lifecycle)
+
+---
+
+## License
+
+MIT — [github.com/steve-magne/hookstack](https://github.com/steve-magne/hookstack)

package/bin/cli.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'fs'
 import { homedir } from 'os'
-import { join } from 'path'
+import { join, dirname } from 'path'
 import { fileURLToPath } from 'url'
 import * as p from '@clack/prompts'
 import pc from 'picocolors'
@@ -17,7 +17,8 @@ import {
 
 const API_BASE = process.env.HOOKSTACK_API_BASE || 'https://hookstack.vercel.app'
 const REPO_URL = 'github.com/steve-magne/hookstack'
-const VERSION = '0.1.3'
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const VERSION = JSON.parse(readFileSync(join(__dirname, '../package.json'), 'utf8')).version
 
 async function fetchHooks(slugs) {
   const url = `${API_BASE}/api/hooks?slugs=${slugs.map(encodeURIComponent).join(',')}`
@@ -222,7 +223,7 @@ async function main() {
   const args = parseArgs(process.argv)
 
   if (args.version) { console.log(VERSION); return }
-  if (args.help || (!args.command && args.hooks.length === 0)) { console.log(HELP); return }
+  if (args.help || args.hooks.length === 0) { console.log(HELP); return }
 
   const command = args.command ?? 'install'
   if (command !== 'install') {
@@ -231,12 +232,6 @@ async function main() {
     process.exit(1)
   }
 
-  if (args.hooks.length === 0) {
-    console.error('✗ No hooks specified. Use --hooks=<slug1>,<slug2>')
-    console.error('  Browse hooks at https://hookstack.vercel.app')
-    process.exit(1)
-  }
-
   const interactive = Boolean(process.stdout.isTTY) && !args.yes
   if (interactive) await interactiveInstall(args.hooks, args)
   else await directInstall(args.hooks, args)

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "hookstack-cli",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "CLI installer for the Hookstack catalogue of Claude Code hooks",
   "type": "module",
   "bin": {
     "hookstack-cli": "./bin/cli.mjs"
   },
   "files": [
-    "bin/"
+    "bin/",
+    "README.md"
   ],
   "engines": {
     "node": ">=18"