85 lines
2.7 KiB
Markdown
85 lines
2.7 KiB
Markdown
# lazysecrets.nvim
|
|
|
|
Brings [lazysecrets](https://github.com/karleinarb/lazysecrets) to Neovim.
|
|
|
|
## Features
|
|
- Prioritizes showing the secrets in the repo you are in
|
|
- The lazysecrets session stays alive for the whole nvim session
|
|
- `e` on a file in lazysecrets will open it in your current nvim session
|
|
- Follows the `:colorscheme` you have set in nvim
|
|
|
|
## Requirements
|
|
Needs Neovim 0.11 or later and `lazysecrets` on your `PATH`. No other
|
|
plugins.
|
|
|
|
## Install
|
|
|
|
With `vim.pack` (Neovim 0.12):
|
|
|
|
```lua
|
|
vim.pack.add({ "https://git.kebcloud.no/keb/lazysecrets.nvim" })
|
|
vim.keymap.set("n", "<leader>ls", function() require("lazysecrets").open() end, { desc = "lazysecrets" })
|
|
```
|
|
|
|
With lazy.nvim:
|
|
|
|
```lua
|
|
{
|
|
url = "https://git.kebcloud.no/keb/lazysecrets.nvim",
|
|
name = "lazysecrets.nvim",
|
|
opts = {},
|
|
cmd = "Lazysecrets",
|
|
keys = { { "<leader>ls", function() require("lazysecrets").open() end, desc = "lazysecrets" } },
|
|
}
|
|
```
|
|
|
|
## Use
|
|
|
|
- `:Lazysecrets` opens it; `:Lazysecrets <link>` opens a `lazysecrets://`
|
|
link, Key Vault URL or reference.
|
|
- `require("lazysecrets").open({ args = { ... }, cwd = ..., win = { ... } })`
|
|
does the same from Lua.
|
|
|
|
## Options
|
|
|
|
`setup()` is only needed to change these. The defaults:
|
|
|
|
```lua
|
|
require("lazysecrets").setup({
|
|
cmd = "lazysecrets",
|
|
-- The floating window: fractions of the editor, and its border.
|
|
win = { width = 0.9, height = 0.9, border = "rounded" },
|
|
-- Where the generated theme is written.
|
|
theme_path = vim.fn.stdpath("cache") .. "/lazysecrets-theme.yaml",
|
|
-- lazysecrets theme roles from highlight groups, e.g.
|
|
-- theme = { activeBorderColor = { fg = "MatchParen", bold = true } },
|
|
})
|
|
```
|
|
|
|
See `lua/lazysecrets/init.lua` for every theme role and its default.
|
|
|
|
## Repositories
|
|
|
|
The main repo of this codebase is at [git.kebcloud.no](https://git.kebcloud.no/keb/lazysecrets.nvim).
|
|
The [GitHub mirror](https://github.com/karleinarb/lazysecrets.nvim) is for discoverability, issue-tracking and releases.
|
|
It also makes it possible to give a ⭐ if you like lazysecrets.nvim!
|
|
|
|
## Contributing
|
|
|
|
I don't take pull requests as I don't have time to review and test them.
|
|
But bug reports and ideas are very welcome!
|
|
Open an [issue on GitHub](https://github.com/karleinarb/lazysecrets.nvim/issues) and I'll have a look.
|
|
|
|
## AI disclosure
|
|
|
|
Built with help from an agentic coding assistant. Every change is requested, reviewed and tested by me before it's merged.
|
|
|
|
## License
|
|
|
|
Copyright © 2026 Karl-Einar Bergstrøm.
|
|
|
|
lazysecrets.nvim is free software: you can redistribute it and/or modify it
|
|
under the terms of the GNU General Public License as published by the Free
|
|
Software Foundation, either version 3 of the License, or (at your option)
|
|
any later version. See [LICENSE](LICENSE).
|