How Hooks Work
Deep integration with Claude Code lifecycle - intercept events and coordinate agents automatically
Zero Merge Conflicts
Automatic file reservations prevent agents from overwriting each other's changes
Without Hooks
Manual coordination
With ULPI Hooks
Automatic coordination
Session Management
Automatic agent registration on startup. Display coordination dashboard and file reservations. Initialize memory context.
File Conflict Prevention
Pre-edit hook checks file reservations. Blocks edits if another agent has claimed the file. Zero merge conflicts, guaranteed.
Memory Preservation
Pre-compact hook creates snapshots before Claude compresses context. Never lose important learnings or decisions.
Agent Messaging Integration
User-prompt hook alerts Claude to urgent messages. See critical coordination info before responding to user.
Obligation Tracking
Post-edit hook shows pending tasks after file modifications. Track what needs review or acknowledgment.
Safe Shutdown
Stop hook blocks termination if critical acks pending. Session-end hook releases all file reservations cleanly.
8 Lifecycle Hooks
Click each hook to see trigger events, exit codes, and MCP tools used
session-start
Register agent identity, display coordination dashboard
Real-World Use Cases
See how hooks enable seamless multi-agent coordination
Multi-Agent Collaboration
3 developers (Alice, Bob, Charlie) work on the same repo simultaneously. File reservations prevent conflicts. Messages coordinate dependencies.
Alice edits auth.ts, Bob tries to edit → blocked by pre-tool-use hook → Bob messages Alice instead
Task Agent Coordination
Main agent spawns 5 subagents for parallel workflows. Each claims unique files. Subagent-stop hook stores learnings to shared memory.
Main agent delegates tasks → Subagents claim files → Work completes → Learnings consolidated
Memory Snapshot Creation
Pre-compact hook fires before Claude compresses context. Critical decisions and architecture choices preserved automatically.
Context approaching limit → Pre-compact hook → Snapshot stored → Compaction proceeds safely
Urgent Message Alerts
Team member sends high-priority message. User-prompt-submit hook alerts Claude before next response. Critical info never missed.
Security issue found → Urgent message sent → Claude sees alert → Addresses immediately
File Reservation Automation
Pre-edit hook auto-claims files on first edit. Shared mode for read-heavy files. Exclusive mode for critical edits. Zero config required.
Claude edits file → Hook reserves it → Other agents see lock → Coordinate through messages
Safe Multi-Agent Shutdown
Stop hook ensures all acknowledgments complete. Session-end releases file locks. Clean handoff to next session.
User hits stop → Pending acks? → Blocked → Complete acks → Graceful shutdown
Automatic Setup
One package, one command - guided setup installs hooks for all your IDEs automatically
Install ULPI Package
One package contains CLI, MCP bridge, and hooks - everything you need
# Install globally (recommended)
npm install -g ulpi
# Or locally in your project
npm install ulpiRun Guided Setup
Interactive setup configures hooks automatically for all supported IDEs
# Run the setup wizard
ulpi setup
# Follow the prompts:
# 1. Enter your API token
# 2. Select your IDE(s)
# 3. Hooks are installed automatically
#
# That's it! Setup handles everything.Restart Your IDE
Hooks activate automatically - zero manual configuration needed
# Restart your IDE (Claude Code, Cursor, Windsurf, etc.)
# Hooks will start intercepting lifecycle events
# Check terminal for hook execution logs
#
# All 8 hooks are now active and coordinating your agents!The guided setup configured everything automatically. All 8 hooks are now active across your IDEs.
Compatible AI Assistants
Works with any AI coding assistant that supports lifecycle hooks
Works with any AI coding assistant that supports lifecycle hooks
Performance Metrics
Optimized for speed - minimal latency on every hook execution