https://github.com/bambooom/gh-noti
gh extension to check unread notifications
https://github.com/bambooom/gh-noti
cli gh gh-extension
Last synced: 11 months ago
JSON representation
gh extension to check unread notifications
- Host: GitHub
- URL: https://github.com/bambooom/gh-noti
- Owner: bambooom
- Created: 2021-09-04T14:26:30.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2021-09-04T15:46:24.000Z (almost 5 years ago)
- Last Synced: 2025-04-09T03:24:09.894Z (about 1 year ago)
- Topics: cli, gh, gh-extension
- Language: Shell
- Homepage:
- Size: 2.93 KB
- Stars: 8
- Watchers: 2
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-gh-extensions - bambooom/gh-noti - 10-11 | gh extension to check unread notifications | (🧩 Categories / Productivity / Workflow)
README
# gh-noti
Github CLI extension to check unread notifications in this [page](https://github.com/notifications).
As the feature is available in `gh`, see [this issue](https://github.com/cli/cli/issues/659).
Still WIP.
## Installation
```sh
gh extension install bambooom/gh-noti
```
Needs `jq` installed
```sh
brew install jq
```
## Usage
1. `gh noti` : list all unread notifications
```
ID Repo Type Title Reason Updated
------- ------ ------- --------------- ------ -------------------
2371625702 zzzzc/openresty-doc PullRequest fix markdown toc sidebar author 2021-09-03T05:56:14Z
1209817679 mengxiong10/vue2-datepicker Issue Vue3 compatibility manual 2021-08-27T20:05:51Z
535892525 axios/axios Issue Handling onUploadProgress on network failure manual 2021-07-27T07:15:54Z
```
Or no unread:
```
✨ No unread notifications.
```
2. `gh noti read`: mark all notifications as read
3. `gh noti read `: use the id in the list to mark one thread as read
## Todo
- [x] mark all as read, https://docs.github.com/en/rest/reference/activity#mark-notifications-as-read
- [x] mark one as read by id, https://docs.github.com/en/rest/reference/activity#mark-a-thread-as-read
- [ ] open a unread notification thread url
## Ref
* [GitHub CLI 2.0 includes extensions! | The GitHub Blog](https://github.blog/2021-08-24-github-cli-2-0-includes-extensions/)
* [Creating GitHub CLI extensions - GitHub Docs](https://docs.github.com/en/github-cli/github-cli/creating-github-cli-extensions)
* no API for marking a notification as 'Done' status as it seems relatively new and maybe changed later, see https://github.community/t/no-api-command-for-new-done-state-of-notifications/122508