Reference & CLI

System Hooks

On this page

System Hooks allow you to run custom scripts when Chain Hub events occur. This is useful for automating deployments, syncing to custom locations, or logging.

Available Hooks

  • pre-setup: Runs before chain setup.
  • post-setup: Runs after chain setup finishes.
  • post-update: Runs after chain update.

How to use

Create a folder named .cursor/hooks (or appropriate for your editor) and add executable scripts.

Note: Hooks are currently in beta and behavior may change. Run chain status to see if hooks are being detected.

ls -F .cursor/hooks/
post-setup.sh*
chain setup
... running post-setup hook ...