AutoMaintainer-bot installs statistics

🛠️ AutoMaintainer Bot helps your team manage technical debt by automatically scanning new commits for TODO comments and creating corresponding GitHub issues.

🧠 It supports inline and multi-line TODOs, generates unique issues with context, and prevents duplicates using hash matching.

Ideal for teams looking to track unfinished work, improve code quality, and streamline collaboration — without leaving GitHub.

Capabilities

• Detects and extracts TODO comments from code on every push. • Automatically creates GitHub Issues for each TODO, including file path, line number, and commit reference. • Prevents duplicate issues using content hashing. • Adds contextual labels to issues and pull requests based on keywords and PR titles. • Ensures required labels exist, creating them with color and description if missing. • Modular and extensible architecture for easy addition of new features or event handlers.

Benefits

• Automated Issue Tracking: No more forgotten TODOs—every TODO in your codebase becomes a tracked GitHub Issue. • Consistent Labeling: Issues and PRs are automatically labeled for better triage and workflow organization. • Developer Productivity: Reduces manual work and context-switching, letting developers focus on code. • Extensible: Easily add new event handlers or customize detection and labeling logic.

Getting Started

Installation

• Install AutoMaintainer-bot on your GitHub repository

• Go to the AutoMaintainer-bot GitHub App page. • Click "Install" and select the repositories you want the bot to monitor.

• Push code with TODO comments

• Add a comment like // TODO: Refactor this code in your source files. • Push your changes to GitHub.

• See the bot in action

• The bot will automatically create an issue for each detected TODO. • Issues and pull requests will be auto-labeled based on their content.

Example Usage

Try these with AutoMaintainer-bot:

• Install the bot on your repository. • Add a TODO comment in your code, for example: // TODO: Refactor this code

• Push your changes to GitHub. • Check the Issues tab: The bot will automatically create a new issue for the TODO. • Open a pull request with a title like "chore: fix dependencies version" and see the bot auto-label your PR.

Description from the GitHub Marketplace listing.