v1.2.0

What's new

• @posthook/node 1.2.0: WebSocket listener support via the SDK
• Forward mode fix: --forward now correctly takes a base URL (hook path is appended automatically)
• Updated headers: Documentation reflects current Posthook signature headers

See the README for usage examples.

v1.1.0

What's New

• Async hooks support in forward mode: callback headers forwarded automatically, Posthook-Async-Timeout relayed on 202 responses
• See the Async Hooks guide for details

v1.0.2

Add per-step retry override support for sequences

v1.0.0

Posthook CLI v1.0.0

The Posthook CLI is now generally available. This release adds project configuration management alongside the existing real-time webhook listener.

What's new

Project config management

Manage your Posthook project settings as code with a posthook.toml file:

• posthook init — Initialize a project and create posthook.toml
• posthook pull — Pull remote config into your local TOML file
• posthook diff — Preview differences between local and remote config
• posthook apply — Apply local config changes to remote (with dry-run support)
• posthook validate — Validate your TOML file locally without API calls
• posthook status — Show project info and signing key

Multi-environment support

Use named configs for different environments:

posthook init --config dev
posthook diff --config dev
posthook apply --config dev

Improvements

• Forward mode now handles aborted requests gracefully
• Extended API client for config endpoints

Install

npm install -g posthook

Or run directly:

npx posthook --help

v0.1.0 - Initial Release

v0.1.0 - Initial Release

The official Posthook CLI for receiving webhook deliveries on your local machine during development.

Installation

# Run directly (no install required)
npx posthook listen

# Or install globally
npm install -g posthook

Features

• Interactive Mode — Receive hooks and manually respond (Accept/Fail/Skip)
• Forward Mode — Automatically forward hooks to a local HTTP endpoint
• Secure Authentication — API key via posthook login, --api-key flag, or POSTHOOK_API_KEY env var
• Auto-Reconnect — Automatic reconnection with exponential backoff
• Debug Logging — Optional debug output with sensitive data redaction

Usage

# Authenticate (one-time)
posthook login

# Interactive mode
posthook listen

# Forward to local server
posthook listen --forward http://localhost:3000/webhooks

# Verbose output
posthook listen --forward http://localhost:3000/webhooks --verbose

Requirements

• Node.js 18.0.0 or higher

Documentation

See the README for full documentation.