dmux Hooks

This directory contains hooks that run automatically at key lifecycle events in dmux.

Quick Start

1. Read the documentation:

   • AGENTS.md - Complete reference (for any AI agent)
   • CLAUDE.md - Same content (Claude Code looks for this filename)

2. Check examples:

   • examples/ directory contains starter templates

3. Create a hook:

   bashCopy

   touch worktree_created
   chmod +x worktree_created
   nano worktree_created
   

4. Test it:

   bashCopy

   export DMUX_ROOT="$(pwd)"
   export DMUX_WORKTREE_PATH="$(pwd)"
   ./worktree_created
   

Available Hooks

• before_pane_create - Before pane creation
• pane_created - After pane created
• worktree_created - After worktree setup
• before_pane_close - Before closing
• pane_closed - After closed
• before_worktree_remove - Before worktree removal
• worktree_removed - After worktree removed
• pre_merge - Before merge
• post_merge - After merge
• run_test - When running tests
• run_dev - When starting dev server

Documentation

See AGENTS.md or CLAUDE.md for complete documentation including:

• Environment variables
• HTTP callback API
• Common patterns
• Best practices
• Testing strategies

Note

This directory is version controlled. Hooks you create here will be shared with your team.