Skip to content

HookRun v1.0.0

Choose a tag to compare

View all tags
@bluvenr bluvenr released this 11 Jun 11:22
· 23 commits to main since this release
v1.0.0
be0c6c4

HookRun v1.0.0

A lightweight webhook action engine — execute custom commands and scripts based on YAML rules.

Features

  • YAML-driven rules — Define all webhook behaviors through YAML config files, zero coding
  • Targeted routing — POST /webhook/{filename} directly routes to a specific config
  • Flexible authentication — Token (Header/Query) + IP whitelist with AND relationship
  • Multi-condition filters — Match against Header / Query / Body with operators: eq ne contains regex
  • Execution policies — block (prevent concurrency), always (always execute), cooldown (rate limiting)
  • Policy inheritance — File-level defaults with per-rule overrides
  • Matching control — allow_all and first_match_only toggles
  • Hot reload — Reload all configs at runtime without restart
  • Log management — Daily rotation with configurable retention
  • Cross-platform — Single binary for Linux, macOS, and Windows

CLI

  • hookrun start [-f] Start server (daemon or foreground)
  • hookrun stop Stop server
  • hookrun restart Restart server
  • hookrun status Show running status
  • hookrun reload Hot-reload YAML configs
  • hookrun validate Validate all config files
  • hookrun version Show version info

Quick Start

hookrun validate
hookrun start

Install

# From source
go install github.com/bluvenr/hookrun/cmd/hookrun@v1.0.0

# Or build from source
git clone https://github.com/bluvenr/hookrun.git
cd hookrun
go build -o hookrun ./cmd/hookrun/
Assets 7
Loading