PHPackages dragon-code/github-notifications - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [CLI & Console](/categories/cli) 4. / 5. dragon-code/github-notifications ActiveProject[CLI & Console](/categories/cli) dragon-code/github-notifications ================================ Reduce your notification burden on GitHub! 1.13.0(5mo ago)6831MITPHPPHP ^8.2CI passing Since Mar 29Pushed 2mo ago1 watchersCompare [ Source](https://github.com/TheDragonCode/github-notifications)[ Packagist](https://packagist.org/packages/dragon-code/github-notifications)[ Fund](https://boosty.to/dragon-code)[ Fund](https://yoomoney.ru/to/410012608840929)[ RSS](/packages/dragon-code-github-notifications/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (10)Dependencies (6)Versions (27)Used By (0) GitHub Notifications ==================== [](#github-notifications) ![GitHub Notifications](https://camo.githubusercontent.com/c7b6c454c732d690f71cb76fbc7af9df0c52f2675e0b5fe6880dab6c832e821e/68747470733a2f2f62616e6e6572732e6265796f6e64636f2e64652f4769744875622532304e6f74696669636174696f6e732e706e673f7061747465726e3d746f706f677261706879267374796c653d7374796c655f3226666f6e7453697a653d3130307078266d643d312673686f7757617465726d61726b3d31267468656d653d6c69676874267061636b6167654d616e616765723d636f6d706f7365722b72657175697265267061636b6167654e616d653d647261676f6e2d636f64652532466769746875622d6e6f74696669636174696f6e73266465736372697074696f6e3d5265647563652b796f75722b6e6f74696669636174696f6e2b62757264656e2b6f6e2b47697448756225323126696d616765733d68747470732533412532462532467777772e7068702e6e6574253246696d616765732532466c6f676f732532466e65772d7068702d6c6f676f2e737667)[![Stable Version](https://camo.githubusercontent.com/0e49fcc466d155291ba5a8c3431a7ad9d8e31ab1d13c9717bc5a90469a970942/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f546865447261676f6e436f64652f6769746875622d6e6f74696669636174696f6e733f6c6162656c3d737461626c65267374796c653d666c61742d737175617265)](https://packagist.org/packages/dragon-code/github-notifications)[![Total Downloads](https://camo.githubusercontent.com/352e084892b0ce5fa5c72e260fa5f0de1f6340b7d059e467ba768c3c26a23bf2/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f647261676f6e2d636f64652f6769746875622d6e6f74696669636174696f6e732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/dragon-code/github-notifications)[![Github Workflow Status](https://camo.githubusercontent.com/f523598fac67c2e2848cb6f85ddd122b132a18705e68a2e7ad9fddcd3bbddfcd/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f546865447261676f6e436f64652f6769746875622d6e6f74696669636174696f6e732f74657374732e796d6c3f7374796c653d666c61742d737175617265)](https://github.com/TheDragonCode/github-notifications/actions)[![License](https://camo.githubusercontent.com/ee06758e240584d71fa7863788ff645285d4c445965f88677538879eb7ee5944/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f647261676f6e2d636f64652f6769746875622d6e6f74696669636174696f6e732e7376673f7374796c653d666c61742d737175617265)](LICENSE) > GitHub Notifications was created by, and is maintained by `The Dragon Code`, and is a simple command line tool to mark all notifications about issues or rejected PRs as read on a given organization. Installation ------------ [](#installation) PHP 8.2+ is required. To get the latest version, simply require the project using [Composer](https://getcomposer.org): ``` composer global require dragon-code/github-notifications:* ``` Alternatively, you can simply clone the repo and run `composer install` in the folder. Update global dependencies -------------------------- [](#update-global-dependencies) To update global dependencies, use the console command: ``` composer global update ``` Authentication -------------- [](#authentication) You'll also need to create yourself a [personal access token](https://github.com/settings/tokens/new?description=Notifications%20Reader)for GitHub's API with access to the `notifications` scope. By default, we check several places for the presence of a token in the following order: 1. The `token` parameter passed when calling the console command 2. The `GITHUB_TOKEN` environment variable 3. `~/.composer/auth.json` file 4. `~/.config/.composer/auth.json` file 5. `~/.config/composer/auth.json` file 6. `~/AppData/Roaming/Composer/auth.json` file 7. `~/composer/auth.json` file 8. `%USERPROFILE%/AppData/Roaming/Composer/auth.json` file If the token is not found, you will receive a message about this. Usage ----- [](#usage) To read all issue notifications: ``` notifications read ``` To clear all issue notifications for the Laravel organization: ``` notifications read laravel ``` Or, if you are specifying a token: ``` notifications read laravel --token {...} ``` In addition, you can use any part of the organization name and/or repository name to check against the template: ``` notifications read laravel/framework # or notifications read lara*/fra # or notifications read framework # or notifications read work # or notifications read fra*rk ``` Pattern matching is implemented using the [`Str::is`](https://laravel.com/docs/strings#method-str-is) method. You can also specify several names: ``` notifications read laravel/framework laravel/jet ``` When determining the name, the [`str_starts_with`](https://www.php.net/manual/en/function.str-starts-with) function is used. ### Options [](#options) By default, only those Issues and Pull Requests that have been closed or merged are marked as read. But you can define the parameters yourself: ``` -r, --except-repository Exclude repositories from processing -i, --except-issues Exclude issues from processing -p, --except-pulls Exclude Pull Requests from processing -m, --except-mentions Exclude notifications with your mention from processing -o, --with-open Process including open Issues and Pull Requests -n, --no-interaction Do not ask any interactive question -q, --quiet Do not output any message ``` For example: ``` # except issues + with open notifications read laravel -ion ``` With this set of options, notifications that have: - whose repository name begins with the word `laravel` - Pull Requests only, both open and closed - will not be asked to continue in the console > You can call the console command to display help information: > > ``` > notifications read --help > ``` You can also exclude certain repositories: ``` notifications read laravel -ion -r laravel/framework -r laravel/breeze ``` With this set of options, notifications that have: - whose repository name begins with the word `laravel` - Pull Requests only, both open and closed - will not be asked to continue in the console - repositories `laravel/framework` and `laravel/breeze` will not be processed Result ------ [](#result) ### Before [](#before) Execute a console command with the following parameters: ``` notifications read -n --except-mentions ``` [![before](.github/images/before.png)](.github/images/before.png) ### After [](#after) [![after](.github/images/after.png)](.github/images/after.png) ### After with `--with-open` option [](#after-with---with-open-option) Execute a console command with the following parameters: ``` notifications read -n --except-mentions --with-open ``` [![after](.github/images/after-with-open.png)](.github/images/after-with-open.png) Support Us ---------- [](#support-us) ❤️ The Dragon Code? Please consider supporting our collective on [Boosty](https://boosty.to/dragon-code). License ------- [](#license) This package is licensed under the [MIT License](LICENSE). ### Health Score 46 — FairBetter than 93% of packages Maintenance80 Actively maintained with recent releases Popularity19 Limited adoption so far Community10 Small or concentrated contributor base Maturity64 Established project with proven stability Bus Factor1 Top contributor holds 86.8% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~31 days Recently: every ~77 days Total 21 Last Release 152d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/b77790e612f1c9beed1e1533e36eba4954fbd6da2a5c9f71e845cd0f5465f0ad?d=identicon)[Helldar](/maintainers/Helldar) --- Top Contributors [![andrey-helldar](https://avatars.githubusercontent.com/u/10347617?v=4)](https://github.com/andrey-helldar "andrey-helldar (210 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (28 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (4 commits)") --- Tags cliconsolenotificationsgithubcleannotifycleanerdragon codeandrey helldarhelldarGitHubNotificationsGitHub Notifications ### Code Quality TestsPest ### Embed Badge ![Health badge](/badges/dragon-code-github-notifications/health.svg) ``` [![Health](https://phpackages.com/badges/dragon-code-github-notifications/health.svg)](https://phpackages.com/packages/dragon-code-github-notifications) ``` ### Alternatives [symfony/console Eases the creation of beautiful and testable command line interfaces 9.8k1.1B11.3k](/packages/symfony-console)[nunomaduro/collision Cli error handling for console/command-line PHP applications. 4.6k331.8M8.5k](/packages/nunomaduro-collision)[nunomaduro/termwind It's like Tailwind CSS, but for the console. 2.5k239.8M286](/packages/nunomaduro-termwind)[wp-cli/php-cli-tools Console utilities for PHP 68325.0M367](/packages/wp-cli-php-cli-tools)[php-school/cli-menu A command line menu helper in PHP 2.0k1.1M27](/packages/php-school-cli-menu)[seld/cli-prompt Allows you to prompt for user input on the command line, and optionally hide the characters they type 24725.8M17](/packages/seld-cli-prompt) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)