Minimal command hook template

json

{
  "version": 1,
  "hooks": {
    "preToolUse": [
      {
        "type": "command",
        "bash": "./scripts/pre-tool.sh",
        "powershell": "./scripts/pre-tool.ps1",
        "cwd": "scripts",
        "timeoutSec": 30
      }
    ]
  }
}

Explanation

The command-hook schema supports `bash`, `powershell`, `cwd`, `env`, and `timeoutSec`.

View in sheet →

Learn the surrounding workflow

Compare similar commands or jump into common fixes when this command is part of a bigger troubleshooting path.

Compare commands View fixes

Related commands

Same sheet · prioritizing Hooks basics

Store hooks in the repository

Hooks are loaded from a repository folder.

Open In sheettextsame section

Run a session-start hook script

Trigger repo automation when a session begins.

Open In sheetjsonsame section

Log prompts for auditing

Call a script that records prompt activity.

Open In sheetjsonsame section

Add an MCP server for one session from a file

Load additional MCP server config at runtime.

Open In sheetbash1 tag match

Project skill directory

Store project skills in the standard directory.

Open In sheettext1 tag match

Disable all built-in MCP servers

Run without the default built-in servers.

Open In sheetbash1 tag match