Home
Softono

Agenix.el

Open source Emacs Lisp
20
Stars
5
Forks
1
Issues
1
Watchers
1 year
Last Commit

 About Agenix.el

Transparent editing for agenix secrets inside Emacs

Platforms

Web Self-hosted

Languages

Emacs Lisp

Links

Need Help Installing Agenix.el?

We provide expert installation service for this software. Our team will install, configure, and secure Agenix.el on your server. plans start at just $30.

  • =agenix.el=

[[https://melpa.org/#/agenix][file:https://melpa.org/packages/agenix-badge.svg]] [[https://stable.melpa.org/#/agenix][file:https://stable.melpa.org/packages/agenix-badge.svg]]

=agenix.el= enables editing =agenix= secrets without leaving emacs.

** Usage

=agenix.el= enables fully transparent =agenix= secrets editing. Open your =agenix= secret as any other file, make changes and save, it'll be automatically encrypted back and saved.

** Prerequisites

You need to have =age= binary in =PATH=, or set =agenix-age-program= variable to path to the executable. If you wish to use =direnv= to set that for you, see [[*Direnv Integration][integration section]]

** Installation

Package is available on [[https://melpa.org/#/agenix][Melpa]], so you can install it as usual.

#+begin_src emacs-lisp ;; Option 1: plain (require 'package) (add-to-list 'package-archives '("melpa" . "https://melpa.org/packages/") t) (package-install 'agenix)

;; Option 2: use-package (use-package agenix :ensure t) #+end_src

*** Direnv Integration

If you wish to use =direnv= using =envrc= package to setup =age= binary path for you, you need to add it to =agenix-pre-mode-hook=. Note that setting =envrc-global-mode= is not enough because minor modes are run after major mode.

#+begin_src emacs-lisp ;; With use-package (use-package envrc :ensure t :hook (agenix-pre-mode . envrc-mode))

;; Without use-package (add-hook 'agenix-pre-mode-hook #'envrc-mode) #+end_src

** License

Copyright (C) 2022 Tomasz Maciosowski (t4ccer)

This program 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.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.