https://github.com/histrio/age-secret.nvim
Automatically encrypt and decrypt .age files
https://github.com/histrio/age-secret.nvim
age decryption encryption file-encryption neovim neovim-lua neovim-plugin rage security
Last synced: 4 months ago
JSON representation
Automatically encrypt and decrypt .age files
- Host: GitHub
- URL: https://github.com/histrio/age-secret.nvim
- Owner: histrio
- License: mit
- Created: 2023-12-10T10:29:45.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-04-21T14:19:12.000Z (about 1 year ago)
- Last Synced: 2025-10-11T05:47:16.408Z (7 months ago)
- Topics: age, decryption, encryption, file-encryption, neovim, neovim-lua, neovim-plugin, rage, security
- Language: Lua
- Homepage:
- Size: 11.7 KB
- Stars: 8
- Watchers: 2
- Forks: 3
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Neovim AGE Plugin
## Description
This Neovim plugin provides seamless integration for handling AGE encrypted files, specifically focusing on files with the `.age` extension. It automates the encryption and decryption process, allowing for a smooth workflow within Neovim.
Features
- Automatically decrypts `.age` files upon opening.
- Encrypts `.age` files before saving.
## Installation
Using packer.nvim
```lua
use {
'histrio/age-secret.nvim',
config = function()
require('age_secret').setup({
-- Configuration options
})
end
}
```
## Configuration
To configure, set the `AGE_RECIPIENT` and `AGE_IDENTITY` environment variables in your shell or operating system.
Alternatively, you can configure these settings within Neovim:
```lua
require('age_secret').setup({
recipient = "age1..." -- Replace with your AGE recipient
identity = "~/age-key.txt" -- Replace with the path to your AGE secret key
})
```
## Usage
- Open a `.age` file - it will be automatically decrypted.
- Save a `.age` file - it will be automatically encrypted.
- Change AGE recipient or identity dynamically:
```vim
:SetAgeRecipient age1...
:SetAgeIdentity ~/age-key.txt
:SetAgeTool /path/to/age
```
## Requirements
Neovim 0.5 or later.
Rage installed and configured on your system.
## Contributing
Contributions are welcome! If you have a feature request, bug report, or suggestion, please open an issue on the GitHub repository.
## License
This plugin is released under the MIT License.