hook

Version, currently main branch1 version
  • main branchlatestAug 28, 2025

github.com/plambert/hook.cr

A simple webhook server

0 stars
0 dependents
License: MIT

Installation

# Add this to your shard.yml
dependencies:
  hook:
    github: plambert/hook.cr
    branch: main

main is a branch, not a release, so this tracks it rather than pinning a version.

Then run:

shards install

shard.yml

Crystal
>= 1.17.1
License
MIT
Author
Paul M. Lambert
Target
  • hook from src/cli.cr

Dependencies

This version declares no dependencies.

README

hook

Simple HTTP server to receive webhooks, and log them, add them to a database, and/or spawn an external program for each one.

Installation

TODO: Write installation instructions here

Usage

% hook

By default, it listens on port 8000 and dumps ALL received requests to STDOUT as JSON, including the full request info.

OPTIONS: (none of these are implemented yet!)

  • --host [:]
    • Sets the host/IP and port to bind to to; can be given multiple times.
  • --logfile
    • Sets the name of the logfile to which to write all received requests; by default, it uses /dev/stdout
    • Can have %{date:%Y%m%d-%H%m%s}, %{hostname}, %{port}, and other template variables

Development

TODO: Write development instructions here

Contributing

  1. Fork it (https://github.com/plambert/hook.cr/fork)
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request

Contributors