@hasnaxyz/hook-checktasks 0.2.5 → 1.0.0

package/README.md

@@ -1,142 +1,150 @@
 # @hasnaxyz/hook-checktasks
 
-A Claude Code hook that prevents Claude from stopping when there are pending tasks.
+A Claude Code hook that prevents Claude from stopping when there are pending tasks in your task list.
 
 ## What it does
 
-This hook intercepts Claude's "Stop" event and:
+When you have a task list configured (`CLAUDE_CODE_TASK_LIST_ID`), this hook:
 
-1. Checks configured task lists for pending/in-progress tasks
-2. If tasks remain → **blocks the stop** and prompts Claude to continue
-3. If all complete → allows stop
+1. Checks if the session name or task list ID contains "dev" (configurable)
+2. Reads the task list from `~/.claude/tasks/{taskListId}/`
+3. If there are pending or in-progress tasks, **blocks the stop** and prompts Claude to continue working
+4. Only allows stopping when all tasks are completed
+
+This ensures Claude doesn't abandon work mid-session.
 
 ## Installation
 
-### 1. Install the CLI globally
+### Prerequisites
 
-```bash
-bun add -g @hasnaxyz/hook-checktasks
-# or
-npm install -g @hasnaxyz/hook-checktasks
-```
+- [Bun](https://bun.sh/) runtime installed
+- Access to `@hasnaxyz` npm organization
 
-### 2. Install the hook
+### Quick Install
 
 ```bash
-# Auto-detect (git repo → project, else → prompt)
-hook-checktasks install
+# Install globally (applies to all Claude Code sessions)
+bunx @hasnaxyz/hook-checktasks install --global
 
-# Install globally
-hook-checktasks install --global
-
-# Install to specific path
-hook-checktasks install /path/to/project
+# Install for current project only
+bunx @hasnaxyz/hook-checktasks install
 ```
 
-The installer will prompt you to configure:
-- **Task list ID**: specific list or leave empty for all lists
-- **Keywords**: session/list name keywords to trigger the check (default: "dev")
-
-## Configuration
-
-### Update configuration
+### Check Installation Status
 
 ```bash
-hook-checktasks config              # Current project
-hook-checktasks config --global     # Global settings
+bunx @hasnaxyz/hook-checktasks status
 ```
 
-### Check status
+### Uninstall
 
 ```bash
-hook-checktasks status
+# Remove from global settings
+bunx @hasnaxyz/hook-checktasks uninstall --global
+
+# Remove from current project
+bunx @hasnaxyz/hook-checktasks uninstall
 ```
 
-Shows:
-- Where hook is installed (global/project)
-- Current configuration
-- Available task lists
+## Configuration
 
-### Uninstall
+Configure via environment variables:
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `CLAUDE_CODE_TASK_LIST_ID` | Task list to monitor (required for task checking) | - |
+| `CHECK_TASKS_KEYWORDS` | Comma-separated keywords that trigger the check | `dev` |
+| `CHECK_TASKS_DISABLED` | Set to `1` to disable the hook | - |
+
+### Examples
 
 ```bash
-hook-checktasks uninstall           # Current project
-hook-checktasks uninstall --global  # Global
-hook-checktasks uninstall /path     # Specific path
+# Standard usage with dev task list
+CLAUDE_CODE_TASK_LIST_ID=myproject-dev claude
+
+# Check for "dev" or "sprint" sessions
+CHECK_TASKS_KEYWORDS=dev,sprint CLAUDE_CODE_TASK_LIST_ID=myproject-dev claude
+
+# Temporarily disable the hook
+CHECK_TASKS_DISABLED=1 claude
 ```
 
-## How Configuration Works
+## How it works
+
+1. **On Stop hook trigger**: Claude is about to stop/exit
+2. **Check session name**: Reads the session name from transcript (if available)
+3. **Keyword matching**: Checks if session name or task list ID contains configured keywords
+4. **Task count**: Reads task files from `~/.claude/tasks/{taskListId}/`
+5. **Decision**:
+   - If tasks remain: Block stop with instructions to continue
+   - If all complete: Allow stop
 
-Configuration is stored in `.claude/settings.json`:
+## What Gets Added to settings.json
+
+The install command adds this to your Claude Code settings:
 
 ```json
 {
   "hooks": {
-    "Stop": [{ "hooks": [{ "type": "command", "command": "bunx @hasnaxyz/hook-checktasks run" }] }]
-  },
-  "checkTasksConfig": {
-    "taskListId": "myproject-dev",
-    "keywords": ["dev"],
-    "enabled": true
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bunx @hasnaxyz/hook-checktasks run",
+            "timeout": 120
+          }
+        ]
+      }
+    ]
   }
 }
 ```
 
-### Config Options
-
-| Option | Description | Default |
-|--------|-------------|---------|
-| `taskListId` | Specific task list to check, or `undefined` for all lists | `undefined` (all) |
-| `keywords` | Keywords to match in session/list names | `["dev"]` |
-| `enabled` | Enable/disable the hook | `true` |
-
-### Priority
-
-1. Project settings (`.claude/settings.json`)
-2. Global settings (`~/.claude/settings.json`)
-3. Environment variables (legacy)
-
-### Legacy Environment Variables
+## Task File Format
 
-Still supported for backwards compatibility:
+Tasks are stored as JSON files in `~/.claude/tasks/{taskListId}/`:
 
-```bash
-CLAUDE_CODE_TASK_LIST_ID=myproject-dev claude
-CHECK_TASKS_KEYWORDS=dev,sprint claude
-CHECK_TASKS_DISABLED=1 claude
+```json
+{
+  "id": "task-001",
+  "subject": "Implement user authentication",
+  "status": "pending"
+}
 ```
 
+Status values: `pending`, `in_progress`, `completed`
+
 ## CLI Commands
 
 ```
-hook-checktasks install [path]     Install the hook
-hook-checktasks config [path]      Update configuration
-hook-checktasks uninstall [path]   Remove the hook
-hook-checktasks status             Show hook status
-hook-checktasks run                Execute hook (called by Claude Code)
+bunx @hasnaxyz/hook-checktasks <command> [options]
+
+Commands:
+  install [--global]   Install the hook to Claude Code settings
+  uninstall [--global] Remove the hook from Claude Code settings
+  run                  Execute the hook (called by Claude Code automatically)
+  status               Show current hook configuration
 
 Options:
-  --global, -g   Apply to global settings
-  /path/to/repo  Apply to specific project
+  --global, -g         Apply to global settings (~/.claude/settings.json)
 ```
 
-## How it Works
+## Development
 
-```
-Claude tries to stop
-        │
-        ▼
-    Stop hook fires
-        │
-        ▼
-    Read config from settings.json
-        │
-        ▼
-    Check matching task lists
-        │
-        ├── Tasks remaining → BLOCK stop, prompt to continue
-        │
-        └── All complete → ALLOW stop
+```bash
+# Clone the repo
+git clone https://github.com/hasnaxyz/hook-checktasks.git
+cd hook-checktasks
+
+# Install dependencies
+bun install
+
+# Build
+bun run build
+
+# Test locally
+bun ./dist/cli.js status
 ```
 
 ## License

package/dist/cli.js

@@ -30,30 +30,6 @@ function readStdinJson() {
     return null;
   }
 }
-function readSettings(path) {
-  if (!existsSync(path))
-    return {};
-  try {
-    return JSON.parse(readFileSync(path, "utf-8"));
-  } catch {
-    return {};
-  }
-}
-function getConfig(cwd) {
-  const projectSettings = readSettings(join(cwd, ".claude", "settings.json"));
-  if (projectSettings[CONFIG_KEY]) {
-    return projectSettings[CONFIG_KEY];
-  }
-  const globalSettings = readSettings(join(homedir(), ".claude", "settings.json"));
-  if (globalSettings[CONFIG_KEY]) {
-    return globalSettings[CONFIG_KEY];
-  }
-  return {
-    taskListId: process.env.CLAUDE_CODE_TASK_LIST_ID,
-    keywords: process.env.CHECK_TASKS_KEYWORDS?.split(",").map((k) => k.trim().toLowerCase()).filter(Boolean) || ["dev"],
-    enabled: process.env.CHECK_TASKS_DISABLED !== "1"
-  };
-}
 function getSessionName(transcriptPath) {
   if (!existsSync(transcriptPath))
     return null;
@@ -83,44 +59,6 @@ function getSessionName(transcriptPath) {
     return null;
   }
 }
-function getAllTaskLists() {
-  const tasksDir = join(homedir(), ".claude", "tasks");
-  if (!existsSync(tasksDir))
-    return [];
-  try {
-    return readdirSync(tasksDir, { withFileTypes: true }).filter((d) => d.isDirectory()).map((d) => d.name);
-  } catch {
-    return [];
-  }
-}
-function getProjectTaskLists(cwd) {
-  const allLists = getAllTaskLists();
-  const dirName = cwd.split("/").filter(Boolean).pop() || "";
-  const projectLists = allLists.filter((list) => {
-    const listLower = list.toLowerCase();
-    const dirLower = dirName.toLowerCase();
-    if (listLower.startsWith(dirLower + "-"))
-      return true;
-    if (listLower === dirLower)
-      return true;
-    return false;
-  });
-  return projectLists;
-}
-function getTasksFromList(listId) {
-  const tasksDir = join(homedir(), ".claude", "tasks", listId);
-  if (!existsSync(tasksDir))
-    return [];
-  try {
-    const taskFiles = readdirSync(tasksDir).filter((f) => f.endsWith(".json"));
-    return taskFiles.map((file) => {
-      const content = readFileSync(join(tasksDir, file), "utf-8");
-      return JSON.parse(content);
-    });
-  } catch {
-    return [];
-  }
-}
 function approve() {
   console.log(JSON.stringify({ decision: "approve" }));
   process.exit(0);
@@ -130,67 +68,51 @@ function block(reason) {
   process.exit(0);
 }
 function run() {
-  const hookInput = readStdinJson();
-  const cwd = hookInput?.cwd || process.cwd();
-  const config = getConfig(cwd);
-  if (config.enabled === false) {
+  if (process.env.CHECK_TASKS_DISABLED === "1") {
     approve();
   }
+  const taskListId = process.env.CLAUDE_CODE_TASK_LIST_ID;
+  if (!taskListId) {
+    approve();
+  }
+  const hookInput = readStdinJson();
   let sessionName = null;
   if (hookInput?.transcript_path) {
     sessionName = getSessionName(hookInput.transcript_path);
   }
-  const nameToCheck = sessionName || config.taskListId || "";
-  const keywords = config.keywords || ["dev"];
-  const matchesKeyword = keywords.some((keyword) => nameToCheck.toLowerCase().includes(keyword.toLowerCase()));
-  if (!matchesKeyword && keywords.length > 0 && nameToCheck) {
+  const nameToCheck = sessionName || taskListId || "";
+  const keywords = (process.env.CHECK_TASKS_KEYWORDS || "dev").split(",").map((k) => k.trim().toLowerCase()).filter(Boolean);
+  const matchesKeyword = keywords.some((keyword) => nameToCheck.toLowerCase().includes(keyword));
+  if (!matchesKeyword) {
     approve();
   }
-  let listsToCheck = [];
-  if (config.taskListId) {
-    listsToCheck = [config.taskListId];
-  } else {
-    const projectLists = getProjectTaskLists(cwd);
-    if (projectLists.length > 0) {
-      if (keywords.length > 0) {
-        listsToCheck = projectLists.filter((list) => keywords.some((keyword) => list.toLowerCase().includes(keyword.toLowerCase())));
-      } else {
-        listsToCheck = projectLists;
-      }
-    }
-  }
-  if (listsToCheck.length === 0) {
+  const tasksDir = join(homedir(), ".claude", "tasks", taskListId);
+  if (!existsSync(tasksDir)) {
     approve();
   }
-  let allPending = [];
-  let allInProgress = [];
-  let allCompleted = [];
-  let activeListId = null;
-  for (const listId of listsToCheck) {
-    const tasks = getTasksFromList(listId);
-    const pending = tasks.filter((t) => t.status === "pending");
-    const inProgress = tasks.filter((t) => t.status === "in_progress");
-    const completed = tasks.filter((t) => t.status === "completed");
-    if (pending.length > 0 || inProgress.length > 0) {
-      activeListId = listId;
-    }
-    allPending.push(...pending);
-    allInProgress.push(...inProgress);
-    allCompleted.push(...completed);
+  const taskFiles = readdirSync(tasksDir).filter((f) => f.endsWith(".json"));
+  if (taskFiles.length === 0) {
+    approve();
   }
-  const remainingCount = allPending.length + allInProgress.length;
+  const tasks = taskFiles.map((file) => {
+    const content = readFileSync(join(tasksDir, file), "utf-8");
+    return JSON.parse(content);
+  });
+  const pending = tasks.filter((t) => t.status === "pending");
+  const inProgress = tasks.filter((t) => t.status === "in_progress");
+  const completed = tasks.filter((t) => t.status === "completed");
+  const remainingCount = pending.length + inProgress.length;
   if (remainingCount > 0) {
-    const nextTasks = allPending.slice(0, 3).map((t) => `- ${t.subject}`).join(`
+    const nextTasks = pending.slice(0, 3).map((t) => `- ${t.subject}`).join(`
 `);
-    const listInfo = activeListId ? ` in "${activeListId}"` : "";
     const prompt = `
-STOP BLOCKED: You have ${remainingCount} tasks remaining${listInfo} (${allPending.length} pending, ${allInProgress.length} in progress, ${allCompleted.length} completed).
+STOP BLOCKED: You have ${remainingCount} tasks remaining (${pending.length} pending, ${inProgress.length} in progress, ${completed.length} completed).
 
 You MUST continue working. Do NOT stop until all tasks are completed.
 
 Next pending tasks:
 ${nextTasks}
-${allPending.length > 3 ? `... and ${allPending.length - 3} more pending tasks` : ""}
+${pending.length > 3 ? `... and ${pending.length - 3} more pending tasks` : ""}
 
 INSTRUCTIONS:
 1. Use TaskList to see all tasks
@@ -206,68 +128,61 @@ DO NOT STOP. Continue working now.
   }
   approve();
 }
-var CONFIG_KEY = "checkTasksConfig";
 var init_hook = __esm(() => {
   if (false) {}
 });
 
 // src/cli.ts
-import { existsSync as existsSync2, readFileSync as readFileSync2, writeFileSync, mkdirSync, readdirSync as readdirSync2 } from "fs";
-import { join as join2, dirname, resolve } from "path";
+import { existsSync as existsSync2, readFileSync as readFileSync2, writeFileSync, mkdirSync } from "fs";
+import { join as join2, dirname } from "path";
 import { homedir as homedir2 } from "os";
-import * as readline from "readline";
 var PACKAGE_NAME = "@hasnaxyz/hook-checktasks";
-var CONFIG_KEY2 = "checkTasksConfig";
-var c = {
+var colors = {
   red: (s) => `\x1B[31m${s}\x1B[0m`,
   green: (s) => `\x1B[32m${s}\x1B[0m`,
   yellow: (s) => `\x1B[33m${s}\x1B[0m`,
   cyan: (s) => `\x1B[36m${s}\x1B[0m`,
-  dim: (s) => `\x1B[2m${s}\x1B[0m`,
   bold: (s) => `\x1B[1m${s}\x1B[0m`
 };
 function printUsage() {
   console.log(`
-${c.bold("hook-checktasks")} - Prevents Claude from stopping with pending tasks
+${colors.bold("@hasnaxyz/hook-checktasks")} - Claude Code hook that prevents stopping with pending tasks
+
+${colors.bold("USAGE:")}
+  bunx ${PACKAGE_NAME} <command> [options]
 
-${c.bold("USAGE:")}
-  hook-checktasks install [path]     Install the hook
-  hook-checktasks config [path]      Update configuration
-  hook-checktasks uninstall [path]   Remove the hook
-  hook-checktasks status             Show hook status
-  hook-checktasks run                Execute hook ${c.dim("(called by Claude Code)")}
+${colors.bold("COMMANDS:")}
+  install [--global]   Install the hook to Claude Code settings
+  uninstall [--global] Remove the hook from Claude Code settings
+  run                  Execute the hook (called by Claude Code automatically)
+  status               Show current hook configuration
 
-${c.bold("OPTIONS:")}
-  ${c.dim("(no args)")}      Auto-detect: if in git repo \u2192 install there, else \u2192 prompt
-  --global, -g            Apply to ~/.claude/settings.json
-  --task-list-id, -t <id> Task list ID (non-interactive)
-  --keywords, -k <k1,k2>  Keywords, comma-separated (non-interactive)
-  --yes, -y               Non-interactive mode, use defaults
-  /path/to/repo           Apply to specific project path
+${colors.bold("OPTIONS:")}
+  --global, -g         Apply to global settings (~/.claude/settings.json)
+                       Without this flag, applies to current project
 
-${c.bold("EXAMPLES:")}
-  hook-checktasks install              ${c.dim("# Install with config prompts")}
-  hook-checktasks install --global     ${c.dim("# Global install")}
-  hook-checktasks install -t myproject-dev -y  ${c.dim("# Non-interactive")}
-  hook-checktasks config               ${c.dim("# Update task list ID, keywords")}
-  hook-checktasks status               ${c.dim("# Check what's installed")}
+${colors.bold("EXAMPLES:")}
+  bunx ${PACKAGE_NAME} install --global    # Install globally
+  bunx ${PACKAGE_NAME} install             # Install in current project
+  bunx ${PACKAGE_NAME} uninstall --global  # Remove from global settings
+  bunx ${PACKAGE_NAME} status              # Show hook status
 
-${c.bold("GLOBAL CLI INSTALL:")}
-  bun add -g ${PACKAGE_NAME}
+${colors.bold("ENVIRONMENT VARIABLES:")}
+  CLAUDE_CODE_TASK_LIST_ID  Task list to monitor (required for task checking)
+  CHECK_TASKS_KEYWORDS      Keywords to trigger check (default: "dev")
+  CHECK_TASKS_DISABLED      Set to "1" to disable the hook
 `);
 }
-function isGitRepo(path) {
-  return existsSync2(join2(path, ".git"));
-}
-function getSettingsPath(targetPath) {
-  if (targetPath === "global") {
+function getSettingsPath(global) {
+  if (global) {
     return join2(homedir2(), ".claude", "settings.json");
   }
-  return join2(targetPath, ".claude", "settings.json");
+  return join2(process.cwd(), ".claude", "settings.json");
 }
-function readSettings2(path) {
-  if (!existsSync2(path))
+function readSettings(path) {
+  if (!existsSync2(path)) {
     return {};
+  }
   try {
     return JSON.parse(readFileSync2(path, "utf-8"));
   } catch {
@@ -280,7 +195,7 @@ function writeSettings(path, settings) {
 `);
 }
 function getHookCommand() {
-  return `bunx ${PACKAGE_NAME}@latest run`;
+  return `bunx ${PACKAGE_NAME} run`;
 }
 function hookExists(settings) {
   const hooks = settings.hooks;
@@ -289,21 +204,15 @@ function hookExists(settings) {
   const stopHooks = hooks.Stop;
   return stopHooks.some((group) => group.hooks?.some((h) => h.command?.includes(PACKAGE_NAME)));
 }
-function getConfig2(settings) {
-  return settings[CONFIG_KEY2] || {};
-}
-function setConfig(settings, config) {
-  settings[CONFIG_KEY2] = config;
-  return settings;
-}
 function addHook(settings) {
   const hookConfig = {
     type: "command",
     command: getHookCommand(),
     timeout: 120
   };
-  if (!settings.hooks)
+  if (!settings.hooks) {
     settings.hooks = {};
+  }
   const hooks = settings.hooks;
   if (!hooks.Stop) {
     hooks.Stop = [{ hooks: [hookConfig] }];
@@ -328,325 +237,96 @@ function removeHook(settings) {
     }
   }
   hooks.Stop = stopHooks.filter((g) => g.hooks && g.hooks.length > 0);
-  if (hooks.Stop.length === 0)
+  if (hooks.Stop.length === 0) {
     delete hooks.Stop;
-  delete settings[CONFIG_KEY2];
-  return settings;
-}
-async function prompt(question) {
-  const rl = readline.createInterface({
-    input: process.stdin,
-    output: process.stdout
-  });
-  return new Promise((resolve2) => {
-    rl.question(question, (answer) => {
-      rl.close();
-      resolve2(answer.trim());
-    });
-  });
-}
-function getAllTaskLists2() {
-  const tasksDir = join2(homedir2(), ".claude", "tasks");
-  if (!existsSync2(tasksDir))
-    return [];
-  try {
-    return readdirSync2(tasksDir, { withFileTypes: true }).filter((d) => d.isDirectory()).map((d) => d.name);
-  } catch {
-    return [];
-  }
-}
-function getProjectTaskLists2(projectPath) {
-  const allLists = getAllTaskLists2();
-  const dirName = projectPath.split("/").filter(Boolean).pop() || "";
-  const projectLists = allLists.filter((list) => {
-    const listLower = list.toLowerCase();
-    const dirLower = dirName.toLowerCase();
-    if (listLower.startsWith(dirLower + "-"))
-      return true;
-    if (listLower.includes(dirLower))
-      return true;
-    return false;
-  });
-  return projectLists;
-}
-function parseInstallArgs(args) {
-  const options = {};
-  for (let i = 0;i < args.length; i++) {
-    const arg = args[i];
-    if (arg === "--global" || arg === "-g") {
-      options.global = true;
-    } else if (arg === "--yes" || arg === "-y") {
-      options.yes = true;
-    } else if (arg === "--task-list-id" || arg === "-t") {
-      options.taskListId = args[++i];
-    } else if (arg === "--keywords" || arg === "-k") {
-      options.keywords = args[++i]?.split(",").map((k) => k.trim().toLowerCase()).filter(Boolean);
-    } else if (!arg.startsWith("-")) {
-      options.path = arg;
-    }
-  }
-  return options;
-}
-async function resolveTarget(args) {
-  if (args.includes("--global") || args.includes("-g")) {
-    return { path: "global", label: "global (~/.claude/settings.json)" };
-  }
-  const pathArg = args.find((a) => !a.startsWith("-"));
-  if (pathArg) {
-    const fullPath = resolve(pathArg);
-    if (!existsSync2(fullPath)) {
-      console.log(c.red("\u2717"), `Path does not exist: ${fullPath}`);
-      return null;
-    }
-    return { path: fullPath, label: `project (${fullPath})` };
-  }
-  const cwd = process.cwd();
-  if (isGitRepo(cwd)) {
-    console.log(c.green("\u2713"), `Detected git repo: ${c.cyan(cwd)}`);
-    return { path: cwd, label: `project (${cwd})` };
-  }
-  console.log(c.yellow("!"), `Current directory: ${c.cyan(cwd)}`);
-  console.log(c.dim(`   (not a git repository)
-`));
-  console.log(`Where would you like to install?
-`);
-  console.log("  1. Here", c.dim(`(${cwd})`));
-  console.log("  2. Global", c.dim("(~/.claude/settings.json)"));
-  console.log(`  3. Enter a different path
-`);
-  const choice = await prompt("Choice (1/2/3): ");
-  if (choice === "1") {
-    return { path: cwd, label: `project (${cwd})` };
-  } else if (choice === "2") {
-    return { path: "global", label: "global (~/.claude/settings.json)" };
-  } else if (choice === "3") {
-    const inputPath = await prompt("Path: ");
-    if (!inputPath) {
-      console.log(c.red("\u2717"), "No path provided");
-      return null;
-    }
-    const fullPath = resolve(inputPath);
-    if (!existsSync2(fullPath)) {
-      console.log(c.red("\u2717"), `Path does not exist: ${fullPath}`);
-      return null;
-    }
-    return { path: fullPath, label: `project (${fullPath})` };
-  } else {
-    console.log(c.red("\u2717"), "Invalid choice");
-    return null;
   }
+  return settings;
 }
-async function promptForConfig(existingConfig = {}, projectPath) {
-  const config = { ...existingConfig };
-  const availableLists = projectPath ? getProjectTaskLists2(projectPath) : getAllTaskLists2();
+function install(global) {
+  const scope = global ? "global" : "project";
+  const settingsPath = getSettingsPath(global);
   console.log(`
-${c.bold("Configuration")}
+${colors.bold("Installing hook-checktasks")} (${scope})
 `);
-  console.log(c.bold("Task List ID:"));
-  if (availableLists.length > 0) {
-    console.log(c.dim("  Available lists for this project:"));
-    availableLists.forEach((list, i) => {
-      console.log(c.dim(`    ${i + 1}. ${list}`));
-    });
-  } else {
-    console.log(c.dim("  No task lists found for this project"));
-  }
-  console.log(c.dim(`  Leave empty to check all matching lists
-`));
-  const currentList = config.taskListId || "(all lists)";
-  const listInput = await prompt(`Task list ID [${c.cyan(currentList)}]: `);
-  if (listInput) {
-    const num = parseInt(listInput, 10);
-    if (!isNaN(num) && num > 0 && num <= availableLists.length) {
-      config.taskListId = availableLists[num - 1];
-    } else {
-      config.taskListId = listInput;
-    }
-  } else if (!existingConfig.taskListId) {
-    config.taskListId = undefined;
-  }
-  const currentKeywords = config.keywords?.join(", ") || "dev";
-  const keywordsInput = await prompt(`Keywords (comma-separated) [${c.cyan(currentKeywords)}]: `);
-  if (keywordsInput) {
-    config.keywords = keywordsInput.split(",").map((k) => k.trim().toLowerCase()).filter(Boolean);
-  } else if (!existingConfig.keywords) {
-    config.keywords = ["dev"];
-  }
-  config.enabled = true;
-  return config;
-}
-async function install(args) {
-  console.log(`
-${c.bold("hook-checktasks install")}
+  if (!global && !existsSync2(join2(process.cwd(), ".git"))) {
+    console.log(colors.yellow("\u26A0 Warning:"), "Current directory is not a git repository");
+    console.log(`  The hook will still be installed to .claude/settings.json
 `);
-  const options = parseInstallArgs(args);
-  let target = null;
-  if (options.global) {
-    target = { path: "global", label: "global (~/.claude/settings.json)" };
-  } else if (options.path) {
-    const fullPath = resolve(options.path);
-    if (!existsSync2(fullPath)) {
-      console.log(c.red("\u2717"), `Path does not exist: ${fullPath}`);
-      return;
-    }
-    target = { path: fullPath, label: `project (${fullPath})` };
-  } else if (options.yes) {
-    const cwd = process.cwd();
-    target = { path: cwd, label: `project (${cwd})` };
-  } else {
-    target = await resolveTarget(args);
   }
-  if (!target)
-    return;
-  const settingsPath = getSettingsPath(target.path);
-  let settings = readSettings2(settingsPath);
+  const settings = readSettings(settingsPath);
   if (hookExists(settings)) {
-    console.log(c.yellow("!"), `Hook already installed in ${target.label}`);
-    if (!options.yes) {
-      const update = await prompt("Update configuration? (y/n): ");
-      if (update.toLowerCase() !== "y")
-        return;
-    }
-  } else {
-    settings = addHook(settings);
-  }
-  const existingConfig = getConfig2(settings);
-  let config;
-  if (options.yes || options.taskListId || options.keywords) {
-    config = {
-      ...existingConfig,
-      taskListId: options.taskListId || existingConfig.taskListId,
-      keywords: options.keywords || existingConfig.keywords || ["dev"],
-      enabled: true
-    };
-  } else {
-    const projectPath = target.path === "global" ? undefined : target.path;
-    config = await promptForConfig(existingConfig, projectPath);
-  }
-  settings = setConfig(settings, config);
-  writeSettings(settingsPath, settings);
-  console.log();
-  console.log(c.green("\u2713"), `Installed to ${target.label}`);
-  console.log();
-  console.log(c.bold("Configuration:"));
-  console.log(`  Task list: ${config.taskListId || c.cyan("(all lists)")}`);
-  console.log(`  Keywords:  ${config.keywords?.join(", ") || "dev"}`);
-  console.log();
-}
-async function configure(args) {
-  console.log(`
-${c.bold("hook-checktasks config")}
+    console.log(colors.yellow("!"), "Hook already installed in", settingsPath);
+    console.log(`
+  To reinstall, run uninstall first:`);
+    console.log(`  bunx ${PACKAGE_NAME} uninstall${global ? " --global" : ""}
 `);
-  const target = await resolveTarget(args);
-  if (!target)
-    return;
-  const settingsPath = getSettingsPath(target.path);
-  if (!existsSync2(settingsPath)) {
-    console.log(c.red("\u2717"), `No settings file at ${settingsPath}`);
-    console.log(c.dim("  Run 'hook-checktasks install' first"));
     return;
   }
-  let settings = readSettings2(settingsPath);
-  if (!hookExists(settings)) {
-    console.log(c.red("\u2717"), `Hook not installed in ${target.label}`);
-    console.log(c.dim("  Run 'hook-checktasks install' first"));
-    return;
-  }
-  const existingConfig = getConfig2(settings);
-  const projectPath = target.path === "global" ? undefined : target.path;
-  const config = await promptForConfig(existingConfig, projectPath);
-  settings = setConfig(settings, config);
-  writeSettings(settingsPath, settings);
+  const updatedSettings = addHook(settings);
+  writeSettings(settingsPath, updatedSettings);
+  console.log(colors.green("\u2713"), "Hook installed to", settingsPath);
   console.log();
-  console.log(c.green("\u2713"), `Configuration updated`);
+  console.log(colors.bold("Configuration (environment variables):"));
+  console.log("  CLAUDE_CODE_TASK_LIST_ID  Task list to monitor (required)");
+  console.log("  CHECK_TASKS_KEYWORDS      Keywords to trigger check (default: 'dev')");
+  console.log("  CHECK_TASKS_DISABLED      Set to '1' to disable the hook");
   console.log();
-  console.log(c.bold("New configuration:"));
-  console.log(`  Task list: ${config.taskListId || c.cyan("(all lists)")}`);
-  console.log(`  Keywords:  ${config.keywords?.join(", ") || "dev"}`);
+  console.log(colors.bold("Usage:"));
+  console.log("  CLAUDE_CODE_TASK_LIST_ID=myproject-dev claude");
   console.log();
 }
-async function uninstall(args) {
+function uninstall(global) {
+  const scope = global ? "global" : "project";
+  const settingsPath = getSettingsPath(global);
   console.log(`
-${c.bold("hook-checktasks uninstall")}
+${colors.bold("Uninstalling hook-checktasks")} (${scope})
 `);
-  const target = await resolveTarget(args);
-  if (!target)
-    return;
-  const settingsPath = getSettingsPath(target.path);
   if (!existsSync2(settingsPath)) {
-    console.log(c.yellow("!"), `No settings file at ${settingsPath}`);
+    console.log(colors.yellow("!"), "No settings file found at", settingsPath);
     return;
   }
-  const settings = readSettings2(settingsPath);
+  const settings = readSettings(settingsPath);
   if (!hookExists(settings)) {
-    console.log(c.yellow("!"), `Hook not found in ${target.label}`);
+    console.log(colors.yellow("!"), "Hook not found in", settingsPath);
     return;
   }
-  const updated = removeHook(settings);
-  writeSettings(settingsPath, updated);
-  console.log(c.green("\u2713"), `Removed from ${target.label}`);
+  const updatedSettings = removeHook(settings);
+  writeSettings(settingsPath, updatedSettings);
+  console.log(colors.green("\u2713"), "Hook removed from", settingsPath);
+  console.log();
 }
 function status() {
   console.log(`
-${c.bold("hook-checktasks status")}
+${colors.bold("hook-checktasks status")}
 `);
-  const globalPath = getSettingsPath("global");
-  const globalSettings = readSettings2(globalPath);
+  const globalPath = getSettingsPath(true);
+  const projectPath = getSettingsPath(false);
+  const globalSettings = readSettings(globalPath);
   const globalInstalled = hookExists(globalSettings);
-  const globalConfig = getConfig2(globalSettings);
-  console.log(globalInstalled ? c.green("\u2713") : c.red("\u2717"), "Global:", globalInstalled ? "Installed" : "Not installed", c.dim(`(${globalPath})`));
-  if (globalInstalled) {
-    console.log(c.dim(`    List: ${globalConfig.taskListId || "(all)"}, Keywords: ${globalConfig.keywords?.join(", ") || "dev"}`));
-  }
-  const cwd = process.cwd();
-  const projectPath = getSettingsPath(cwd);
+  console.log(globalInstalled ? colors.green("\u2713") : colors.red("\u2717"), "Global:", globalInstalled ? "Installed" : "Not installed", colors.cyan(`(${globalPath})`));
   if (existsSync2(projectPath)) {
-    const projectSettings = readSettings2(projectPath);
+    const projectSettings = readSettings(projectPath);
     const projectInstalled = hookExists(projectSettings);
-    const projectConfig = getConfig2(projectSettings);
-    console.log(projectInstalled ? c.green("\u2713") : c.red("\u2717"), "Project:", projectInstalled ? "Installed" : "Not installed", c.dim(`(${projectPath})`));
-    if (projectInstalled) {
-      console.log(c.dim(`    List: ${projectConfig.taskListId || "(all)"}, Keywords: ${projectConfig.keywords?.join(", ") || "dev"}`));
-    }
+    console.log(projectInstalled ? colors.green("\u2713") : colors.red("\u2717"), "Project:", projectInstalled ? "Installed" : "Not installed", colors.cyan(`(${projectPath})`));
   } else {
-    console.log(c.dim("\xB7"), "Project:", c.dim("No .claude/settings.json"));
-  }
-  const projectLists = getProjectTaskLists2(cwd);
-  if (projectLists.length > 0) {
-    console.log();
-    console.log(c.bold("Task lists for this project:"));
-    projectLists.forEach((list) => console.log(c.dim(`  - ${list}`)));
-  } else {
-    const allLists = getAllTaskLists2();
-    if (allLists.length > 0) {
-      console.log();
-      console.log(c.bold("All task lists:"), c.dim("(none match this project)"));
-      allLists.slice(0, 10).forEach((list) => console.log(c.dim(`  - ${list}`)));
-      if (allLists.length > 10) {
-        console.log(c.dim(`  ... and ${allLists.length - 10} more`));
-      }
-    }
-  }
-  const envTaskList = process.env.CLAUDE_CODE_TASK_LIST_ID;
-  if (envTaskList) {
-    console.log();
-    console.log(c.bold("Environment (legacy):"));
-    console.log(`  CLAUDE_CODE_TASK_LIST_ID: ${envTaskList}`);
+    console.log(colors.red("\u2717"), "Project: No .claude/settings.json");
   }
   console.log();
+  console.log(colors.bold("Environment:"));
+  console.log("  CLAUDE_CODE_TASK_LIST_ID:", process.env.CLAUDE_CODE_TASK_LIST_ID || colors.yellow("(not set)"));
+  console.log("  CHECK_TASKS_KEYWORDS:", process.env.CHECK_TASKS_KEYWORDS || "dev (default)");
+  console.log("  CHECK_TASKS_DISABLED:", process.env.CHECK_TASKS_DISABLED === "1" ? colors.yellow("yes") : "no");
+  console.log();
 }
 var args = process.argv.slice(2);
 var command = args[0];
-var commandArgs = args.slice(1);
+var isGlobal = args.includes("--global") || args.includes("-g");
 switch (command) {
   case "install":
-    install(commandArgs);
-    break;
-  case "config":
-    configure(commandArgs);
+    install(isGlobal);
     break;
   case "uninstall":
-    uninstall(commandArgs);
+    uninstall(isGlobal);
     break;
   case "run":
     Promise.resolve().then(() => (init_hook(), exports_hook)).then((m) => m.run());
@@ -660,7 +340,7 @@ switch (command) {
     printUsage();
     break;
   default:
-    console.error(c.red(`Unknown command: ${command}`));
+    console.error(colors.red(`Unknown command: ${command}`));
     printUsage();
     process.exit(1);
 }

package/dist/hook.js

@@ -17,7 +17,6 @@ var __require = /* @__PURE__ */ createRequire(import.meta.url);
 import { readdirSync, readFileSync, existsSync } from "fs";
 import { join } from "path";
 import { homedir } from "os";
-var CONFIG_KEY = "checkTasksConfig";
 function readStdinJson() {
   try {
     const stdin = readFileSync(0, "utf-8");
@@ -26,30 +25,6 @@ function readStdinJson() {
     return null;
   }
 }
-function readSettings(path) {
-  if (!existsSync(path))
-    return {};
-  try {
-    return JSON.parse(readFileSync(path, "utf-8"));
-  } catch {
-    return {};
-  }
-}
-function getConfig(cwd) {
-  const projectSettings = readSettings(join(cwd, ".claude", "settings.json"));
-  if (projectSettings[CONFIG_KEY]) {
-    return projectSettings[CONFIG_KEY];
-  }
-  const globalSettings = readSettings(join(homedir(), ".claude", "settings.json"));
-  if (globalSettings[CONFIG_KEY]) {
-    return globalSettings[CONFIG_KEY];
-  }
-  return {
-    taskListId: process.env.CLAUDE_CODE_TASK_LIST_ID,
-    keywords: process.env.CHECK_TASKS_KEYWORDS?.split(",").map((k) => k.trim().toLowerCase()).filter(Boolean) || ["dev"],
-    enabled: process.env.CHECK_TASKS_DISABLED !== "1"
-  };
-}
 function getSessionName(transcriptPath) {
   if (!existsSync(transcriptPath))
     return null;
@@ -79,44 +54,6 @@ function getSessionName(transcriptPath) {
     return null;
   }
 }
-function getAllTaskLists() {
-  const tasksDir = join(homedir(), ".claude", "tasks");
-  if (!existsSync(tasksDir))
-    return [];
-  try {
-    return readdirSync(tasksDir, { withFileTypes: true }).filter((d) => d.isDirectory()).map((d) => d.name);
-  } catch {
-    return [];
-  }
-}
-function getProjectTaskLists(cwd) {
-  const allLists = getAllTaskLists();
-  const dirName = cwd.split("/").filter(Boolean).pop() || "";
-  const projectLists = allLists.filter((list) => {
-    const listLower = list.toLowerCase();
-    const dirLower = dirName.toLowerCase();
-    if (listLower.startsWith(dirLower + "-"))
-      return true;
-    if (listLower === dirLower)
-      return true;
-    return false;
-  });
-  return projectLists;
-}
-function getTasksFromList(listId) {
-  const tasksDir = join(homedir(), ".claude", "tasks", listId);
-  if (!existsSync(tasksDir))
-    return [];
-  try {
-    const taskFiles = readdirSync(tasksDir).filter((f) => f.endsWith(".json"));
-    return taskFiles.map((file) => {
-      const content = readFileSync(join(tasksDir, file), "utf-8");
-      return JSON.parse(content);
-    });
-  } catch {
-    return [];
-  }
-}
 function approve() {
   console.log(JSON.stringify({ decision: "approve" }));
   process.exit(0);
@@ -126,67 +63,51 @@ function block(reason) {
   process.exit(0);
 }
 function run() {
-  const hookInput = readStdinJson();
-  const cwd = hookInput?.cwd || process.cwd();
-  const config = getConfig(cwd);
-  if (config.enabled === false) {
+  if (process.env.CHECK_TASKS_DISABLED === "1") {
+    approve();
+  }
+  const taskListId = process.env.CLAUDE_CODE_TASK_LIST_ID;
+  if (!taskListId) {
     approve();
   }
+  const hookInput = readStdinJson();
   let sessionName = null;
   if (hookInput?.transcript_path) {
     sessionName = getSessionName(hookInput.transcript_path);
   }
-  const nameToCheck = sessionName || config.taskListId || "";
-  const keywords = config.keywords || ["dev"];
-  const matchesKeyword = keywords.some((keyword) => nameToCheck.toLowerCase().includes(keyword.toLowerCase()));
-  if (!matchesKeyword && keywords.length > 0 && nameToCheck) {
+  const nameToCheck = sessionName || taskListId || "";
+  const keywords = (process.env.CHECK_TASKS_KEYWORDS || "dev").split(",").map((k) => k.trim().toLowerCase()).filter(Boolean);
+  const matchesKeyword = keywords.some((keyword) => nameToCheck.toLowerCase().includes(keyword));
+  if (!matchesKeyword) {
     approve();
   }
-  let listsToCheck = [];
-  if (config.taskListId) {
-    listsToCheck = [config.taskListId];
-  } else {
-    const projectLists = getProjectTaskLists(cwd);
-    if (projectLists.length > 0) {
-      if (keywords.length > 0) {
-        listsToCheck = projectLists.filter((list) => keywords.some((keyword) => list.toLowerCase().includes(keyword.toLowerCase())));
-      } else {
-        listsToCheck = projectLists;
-      }
-    }
-  }
-  if (listsToCheck.length === 0) {
+  const tasksDir = join(homedir(), ".claude", "tasks", taskListId);
+  if (!existsSync(tasksDir)) {
     approve();
   }
-  let allPending = [];
-  let allInProgress = [];
-  let allCompleted = [];
-  let activeListId = null;
-  for (const listId of listsToCheck) {
-    const tasks = getTasksFromList(listId);
-    const pending = tasks.filter((t) => t.status === "pending");
-    const inProgress = tasks.filter((t) => t.status === "in_progress");
-    const completed = tasks.filter((t) => t.status === "completed");
-    if (pending.length > 0 || inProgress.length > 0) {
-      activeListId = listId;
-    }
-    allPending.push(...pending);
-    allInProgress.push(...inProgress);
-    allCompleted.push(...completed);
+  const taskFiles = readdirSync(tasksDir).filter((f) => f.endsWith(".json"));
+  if (taskFiles.length === 0) {
+    approve();
   }
-  const remainingCount = allPending.length + allInProgress.length;
+  const tasks = taskFiles.map((file) => {
+    const content = readFileSync(join(tasksDir, file), "utf-8");
+    return JSON.parse(content);
+  });
+  const pending = tasks.filter((t) => t.status === "pending");
+  const inProgress = tasks.filter((t) => t.status === "in_progress");
+  const completed = tasks.filter((t) => t.status === "completed");
+  const remainingCount = pending.length + inProgress.length;
   if (remainingCount > 0) {
-    const nextTasks = allPending.slice(0, 3).map((t) => `- ${t.subject}`).join(`
+    const nextTasks = pending.slice(0, 3).map((t) => `- ${t.subject}`).join(`
 `);
-    const listInfo = activeListId ? ` in "${activeListId}"` : "";
     const prompt = `
-STOP BLOCKED: You have ${remainingCount} tasks remaining${listInfo} (${allPending.length} pending, ${allInProgress.length} in progress, ${allCompleted.length} completed).
+STOP BLOCKED: You have ${remainingCount} tasks remaining (${pending.length} pending, ${inProgress.length} in progress, ${completed.length} completed).
 
 You MUST continue working. Do NOT stop until all tasks are completed.
 
 Next pending tasks:
 ${nextTasks}
-${allPending.length > 3 ? `... and ${allPending.length - 3} more pending tasks` : ""}
+${pending.length > 3 ? `... and ${pending.length - 3} more pending tasks` : ""}
 
 INSTRUCTIONS:
 1. Use TaskList to see all tasks

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasnaxyz/hook-checktasks",
-  "version": "0.2.5",
+  "version": "1.0.0",
   "description": "Claude Code hook that prevents stopping when there are pending tasks",
   "type": "module",
   "bin": {