A lightweight, unobstructive, yet WIP neovim plugin for viewing GitHub notifications in your statusline + Telescope popup. All requests are processed asynchronously, debounced and cached to ensure no delays in your UI! π
Use your favourite package manager:
use { 'rlch/github-notifications.nvim', config = [[require('config.github-notifications')]], requires = { 'nvim-lua/plenary.nvim', 'nvim-telescope/telescope.nvim', }, }
Install the CLI and you're off!
Make sure you authenticate with gh auth login.
Call setup with your personal access token with the Notifications scope. You can make one here.
local secrets = require 'secrets' require('github-notifications').setup { username = secrets.username, token = secrets.token, }
Default config:
local defaults = { github_api_endpoint = 'https://api.github.com', -- Github API Endpoint username = nil, -- GitHub username token = nil, -- Your personal access token with `notifications` scope icon = 'ο', -- Icon to be shown in statusline hide_statusline_on_all_read = true, hide_entry_on_read = false, -- Whether to hide the Telescope entry after reading (buggy) debounce_duration = 60, -- Minimum time until next refresh cache = false, -- Opt in/out of caching sort_unread_first = true, mappings = { mark_read = '<CR>', hide = 'd', -- remove from Telescope picker, but don't mark as read -- open_in_browser = 'o', (WIP) }, prompt_mappings = { mark_all_read = '<C-r>' } -- keymaps that apply on a Telescope prompt level (insert mode) }
I've only tested this with lualine, but it should work with any Lua-based statusline that takes a Lua function as an argument for displaying data.
require('lualine').setup { ... sections = { ... lualine_b = { 'branch', require('github-notifications').statusline_notification_count }, ... }, ... }
You can also use statusline_notifications() and build your own formatter:
local ghn_formatter = function() local data = require('github-notifications').statusline_notifications() if data.count > 10 then return data.icon .. ' purge time' elseif data.count == 0 then return '' end return data.icon .. tostring(data.count) end
Optionally load the extension using:
require('telescope').load_extension 'ghn'
So that require('telescope').extensions.ghn.notifications() can open the popup.
Otherwise, you can simply call:
require('github-notifications.menu').notifications()
I'm aware my API design is abysmal
- Add support for CI status for current branch in statusline
- Redirect to follow-up URL (instead of API url)
- Refresh UI on state changes (i.e. when marking notifications as read)
- Add highlights to Telescope entries
- Improve Telescope preview UI instead of being lazy with markdown
- Hide notifications without Telescope shitting itself
Please lmao