{"id":18459140,"url":"https://github.com/smartbear/bumbailiff","last_synced_at":"2026-01-31T01:20:36.635Z","repository":{"id":42064092,"uuid":"316296587","full_name":"SmartBear/bumbailiff","owner":"SmartBear","description":"Keeps your technical debt under control.","archived":false,"fork":false,"pushed_at":"2024-11-22T15:28:58.000Z","size":15,"stargazers_count":12,"open_issues_count":7,"forks_count":4,"subscribers_count":10,"default_branch":"main","last_synced_at":"2025-03-19T07:05:11.996Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SmartBear.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-11-26T17:26:06.000Z","updated_at":"2025-02-15T00:04:15.000Z","dependencies_parsed_at":"2024-11-06T08:26:13.361Z","dependency_job_id":"95de818b-3322-4953-85d5-71c3606f0a8e","html_url":"https://github.com/SmartBear/bumbailiff","commit_stats":{"total_commits":30,"total_committers":5,"mean_commits":6.0,"dds":0.2666666666666667,"last_synced_commit":"ed3549671d72d9197f2d0fe9d109ad930de5cc03"},"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SmartBear%2Fbumbailiff","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SmartBear%2Fbumbailiff/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SmartBear%2Fbumbailiff/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SmartBear%2Fbumbailiff/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SmartBear","download_url":"https://codeload.github.com/SmartBear/bumbailiff/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247785919,"owners_count":20995641,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-06T08:22:00.074Z","updated_at":"2026-01-31T01:20:36.565Z","avatar_url":"https://github.com/SmartBear.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Bumbailiff\n\nKeep your technical debt under control.\n\nCheck out our [blog post](https://cucumber.io/blog/bdd/todo-or-not-todo/) to learn more about the concept behind this tool. Bumbailiff works on any git repository.\n\n## Installation\n\nThere are several ways of installing and running bumbailiff.\n\n### Node.js / NPM\n\nIf you have [Node.js](https://nodejs.org/en/) and [NPM](https://docs.npmjs.com/about-npm) installed, you can use [`npx`](https://docs.npmjs.com/cli/v7/commands/npx) to execute bumbailiff:\n\n    npx bumbailiff\n\nYou can add bumbailiff to your Node.js project:\n\n    npm install --save-dev bumbailiff\n\nOr alternatively:\n\n    yarn add --dev bumbailiff\n\n### Manual download\n\nDownload and decompress the archive of this repository in the directory of your choice:\n\n    curl -LO https://github.com/SmartBear/bumbailiff/archive/main.zip\n    unzip main.zip\n\nAdd the location of the `bumbailiff-main/src` dir to your `$PATH`.\n\n## Usage\n\n    bumbailiff 10\n\nThis will check that you git repository does not contain more than 10 days of accumulated TODO-days. To do so, bumbailiff will query your git repository and search for all the TODOs it can find, compute the age of each one and print out the sum.\n\nThe maximum debt age is optional and defaults to 14.\n\n## Set up on your project\n\nAfter installing bumbailiff, you might want to set up a pre-push hook in your repository to prevent pushing if the tech debt limit has been reached:\n\n    echo \"#\\!/usr/bin/env bash\\nbumbailiff\" \u003e\u003e .git/hooks/pre-push \u0026\u0026 chmod +x .git/hooks/pre-push\n\n## Other development practice tools\n\nAt Cucumber and Smartbear, we also use other tools that make our software development practices as a (remote) mob more healthy:\n\n- [Architecture Decision Records tools](https://github.com/npryce/adr-tools): keep track of the decisions your team makes;\n- [Retro tools](https://github.com/tooky/retro-tools): log your team retrospective outcomes.\n\n## Credits\n\nThis project is based off the [original work](https://gist.github.com/aslakhellesoy/de419d6ded6249e8a68c05d296314bf2) of [Aslak Hellesøy](https://github.com/aslakhellesoy). Some of the bash work around bumbailiff was also inspired by [Steve Tooke](https://github.com/tooky/)'s [retro-tools](https://github.com/tooky/retro-tools) who was himself inspired by [Nat Pryce](https://github.com/npryce)'s work.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsmartbear%2Fbumbailiff","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsmartbear%2Fbumbailiff","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsmartbear%2Fbumbailiff/lists"}