Trigger repo automation when a session begins.

Section: Hooks basics

Run a session-start hook script

json
json
{
  "type": "command",
  "bash": "./scripts/session-start.sh",
  "powershell": "./scripts/session-start.ps1",
  "cwd": "scripts",
  "timeoutSec": 30
}
Explanation

Session start hooks can log, bootstrap, or validate repo state before the agent proceeds.

Learn the surrounding workflow

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

Related commands

Same sheet · prioritizing Hooks basics
Store hooks in the repository
Hooks are loaded from a repository folder.
OpenIn sheettextsame section
Minimal command hook template
Start with a JSON hook file.
OpenIn sheetjsonsame section
Log prompts for auditing
Call a script that records prompt activity.
OpenIn sheetjsonsame section
Add an MCP server for one session from a file
Load additional MCP server config at runtime.
OpenIn sheetbash1 tag match
Project skill directory
Store project skills in the standard directory.
OpenIn sheettext1 tag match
Disable all built-in MCP servers
Run without the default built-in servers.
OpenIn sheetbash1 tag match