Never forget to star a repo

Automatically star all the Neovim plugins you use.

See :h thanks if you are in Neovim.

After installing thanks.nvim, you must first log in to GitHub using the :ThanksGithubAuth command. This step is necessary only once.

Once you're authenticated, you can star all the installed plugins using the :ThanksAll command.
If you have unstar_on_uninstall set to true, it will also unstar the plugins that are not installed anymore.

The initial run may take a minute if you have a lot of plugins, but next runs will be faster due to the utilization of a local cache.
The local cache can be deleted using the :ThanksClearCache command. It will be recreated the next time you execute :ThanksAll.

With the default configuration, every time a new plugin is installed, :ThanksAll will be automatically executed (set star_on_startup to true if you want to check on each Neovim startup, see caveat).

• A plugin manager: lazy.nvim, packer or mini.deps
• Linux or MacOs: not tested on Windows but maybe work, please let me know if you try it.
• cURL: if you don't have curl installed, use your favorite package manager to install it.

• With lazy.nvim

-- add this to your lua/plugins.lua, lua/plugins/init.lua, or the file you keep your other plugins:
{
    'jsongerber/thanks.nvim',
    config = true,
}

• With packer

use({
    'jsongerber/thanks.nvim',
    config = function()
        require("thanks").setup()
    end,
})

• With mini.deps

add({
	source = "/Users/jasongerber/Documents/neovim-plugins/thanks.nvim",
	checkout = 'dev'
})

require('thanks').setup({
	star_on_install = false, -- not supported by mini.deps, see caveat section of the README or the help
})

-- Those are the default values and can be ommited
require("thanks").setup({
	star_on_install = true,
	star_on_startup = false,
	ignore_repos = {},
	ignore_authors = {},
	unstar_on_uninstall = false,
	ask_before_unstarring = false,
})

• If your plugin manager sync plugins on Neovim startup (default on Lazy.nvim, unsure about Packer), there's a good chance it does before thanks.nvim is loaded and therefor cannot star/unstar the plugins directly. Thoses new plugins will be starred/unstarred on the next sync that does not happen on startup or if you call :ThanksAll manually, if you want to always be up to date with your stars, set star_on_startup to true.
• If you have unstar_on_uninstall set to true and you uninstall thanks.nvim, it won't be able to unstar itself as plugin manager don't let plugins say their last words before deleting them.
• thanks.nvim knows which repos it already starred, but doesn't check if you manually starred/unstarred a repo, if you manually star a repo on github.com and then install it, it will tell you that you just starred it, even though it was already starred.
• mini.deps does not support star_on_install as it does not have a way to run a function after installing a plugin (as far as I know), use star_on_install or run :ThanksAll manually.

Uninstall the plugin as you normally would, if you want to clean everything, you can delete the cache file and the saved access token:

rm path/to/jsongerber-thanks.json

To find the path of this file, you can run the following command in neovim:

:lua vim.print(vim.fn.stdpath("data") .. "/jsongerber-thanks.json")

PRs and issues are always welcome. Make sure to provide as much context as possible when opening one.

Will do if there is demand (open issue or PR)

• Other plugin managers
• Unstar on uninstall
• Automatically detect plugin manager
• Command to star/unstar a single plugin
• Command to uninstall thanks.nvim

MIT © jsongerber

See my other plugins:

• telescope-ssh-config: A plugin to list and connect to ssh hosts with telescope.nvim.
• nvim-px-to-rem: A plugin to convert px to rem in Neovim.