What is the background subshell pattern for hooks?

It involves wrapping your script commands in '( commands ) &>/dev/null &' and exiting immediately with 'exit 0' so long-running tasks continue in the background without blocking Claude.

Why do I get a 'Hook cancelled' error in Claude Code?

This error occurs when a lifecycle hook execution exceeds the default 60-second timeout limit set by Claude Code.

Does this skill help with Starship prompt warnings?

Yes, it provides specific configurations for starship.toml to increase command_timeout and optimize nodejs detection to prevent terminal lag.

Where are Claude Code hook settings stored?

Hooks are configured in .claude/settings.json, which can be located at the user level (~/.claude/settings.json) or the project root level.

How can I increase the timeout for a specific Claude hook?

You can add a 'timeout' field with a numeric value (in seconds) to your hook configuration object within the .claude/settings.json file.

Claude Code Hooks Configuration

Name: Claude Code Hooks Configuration
Author: laurigates

bylaurigates

•

Developer Tools

Optimizes Claude Code lifecycle hooks with custom timeout settings and background execution patterns to prevent session management errors.

About

This skill provides comprehensive guidance for configuring Claude Code's lifecycle hooks, including SessionStart, SessionEnd, and Tool hooks. It specifically addresses the common 'Hook cancelled' error by implementing robust timeout management strategies and background subshell patterns, ensuring that long-running tasks like logging, cleanup, and environment setup do not disrupt your development workflow or cause session failures.

Key Features

Standardized JSON structures for user and project-level settings
3 GitHub stars
Advanced timeout management to prevent 'Hook cancelled' errors
Background subshell patterns for non-blocking asynchronous hook execution
Comprehensive lifecycle hook configuration (SessionStart, SessionEnd, Stop, Tool hooks)
Starship prompt timeout optimization for improved terminal responsiveness

Use Cases

Automating session logging and cleanup without blocking the terminal interface
Fixing shell latency issues by optimizing Starship prompt and node detection timeouts
Running complex environment checks or dependency updates during session startup

About

Key Features

Standardized JSON structures for user and project-level settings
3 GitHub stars
Advanced timeout management to prevent 'Hook cancelled' errors
Background subshell patterns for non-blocking asynchronous hook execution
Comprehensive lifecycle hook configuration (SessionStart, SessionEnd, Stop, Tool hooks)
Starship prompt timeout optimization for improved terminal responsiveness

Use Cases

Automating session logging and cleanup without blocking the terminal interface
Fixing shell latency issues by optimizing Starship prompt and node detection timeouts
Running complex environment checks or dependency updates during session startup