Can I use TypeScript to write hooks?

Yes, the recommended pattern uses a shell wrapper to execute a TypeScript handler via npx tsx, providing full access to the TypeScript ecosystem.

What events can I trigger hooks on?

Available events include PreToolUse, PostToolUse, UserPromptSubmit, PreCompact, SessionStart, and Stop.

What is a Maestro hook?

A Maestro hook is a specialized script that allows you to intercept and modify the behavior of Claude Code during specific events, such as starting a session or using a tool.

Where are these hooks registered?

Hooks are registered in the .maestro/settings.json file, where you can define the event type, optional matchers, and the command to execute.

How do I block an action in Claude Code using a hook?

By implementing a PreToolUse hook and returning a JSON object with the result set to 'block', you can prevent the agent from executing a specific tool.

Maestro Hook Development

Name: Maestro Hook Development
Author: scooter-lacroix

byscooter-lacroix

Developer Tools

Standardizes the creation and management of event-driven lifecycle hooks for the Maestro framework within Claude Code.

About

This skill provides a structured framework for developing and implementing lifecycle hooks in Maestro, allowing users to intercept and customize Claude's behavior. By utilizing a standardized shell-to-TypeScript pattern, it enables the creation of handlers for critical events like tool execution, session starts, and prompt submissions. This is essential for developers looking to build sophisticated automation, enforce custom security policies, or maintain session continuity within their AI-driven workflows.

Key Features

Centralized JSON registration for managing multiple hooks and matchers
0 GitHub stars
Standardized shell-to-TypeScript execution pattern for robust hook logic
Support for comprehensive event triggers including PreToolUse, PostToolUse, and SessionStart
Action blocking capabilities to prevent unauthorized or unsafe tool executions
Manual testing interface for validating hook logic via CLI

Use Cases

Enforcing security guardrails by blocking specific tool uses based on context
Logging or auditing agent activities after tool execution for compliance
Automating project initialization or context loading when a new Claude session starts

About

Key Features

Centralized JSON registration for managing multiple hooks and matchers
0 GitHub stars
Standardized shell-to-TypeScript execution pattern for robust hook logic
Support for comprehensive event triggers including PreToolUse, PostToolUse, and SessionStart
Action blocking capabilities to prevent unauthorized or unsafe tool executions
Manual testing interface for validating hook logic via CLI

Use Cases

Enforcing security guardrails by blocking specific tool uses based on context
Logging or auditing agent activities after tool execution for compliance
Automating project initialization or context loading when a new Claude session starts