Skip to content
Notify when watched file(s) change in a GitHub repo
Ruby
Branch: master
Clone or download
Latest commit 515e766 Jul 15, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
Gemfile Adding slack notification support Jun 17, 2019
Gemfile.lock Adding slack notification support Jun 17, 2019
LICENSE Adding MIT license Jun 17, 2019
README.md Updated readme Jul 15, 2019
app.json app.json to deploy to Heroku Jul 14, 2019
config.ru
server.rb Bug fix for empy commits Jul 15, 2019

README.md

Commit Hawk 🦅

WHY?

Watching a repository on GitHub tells you about social activity (e.g. PRs, issues, etc.), but it doesn't notify you about file-level changes that you and your team might care about.

For example, when an external vendor merges in their work, or when a critical part of the codebase is changed, or when new dependencies are added, etc

Commit Hawk fills that gap.

INSTALLATION

Deploy
  1. Deploy this project to Heroku or your platform of choice.

  2. Install the Incoming Slack Webhook app to your Slack workspace. Add the webhook URL to this deployment's SLACK_WEBHOOK_URL environment variable

  3. Add this deployment URL as a webhook in the GitHub repository you want to track under it's Settings -> Webhooks with the following params:

    • Payload URL: http://your-deployment.heroku.com/payload?watching=path/to/some/dir/or/file
    • Generate and take a note of the secret and add it to your deploy's WEBHOOK_SECRET_TOKEN environment variable
    • Content Type: application/x-www-form-urlencoded
    • Which events would you like to trigger this webhook? Just the push event.
  4. That's it! When the files you are watching change, you will get a Slack notification.

CONTRIBUTE!

If you like what this does, feel free to improve upon code. Just follow these steps to contribute:

  1. Fork it
  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. Issue a pull request
You can’t perform that action at this time.