emacs-twist/twist.el

Hot-reload Emacs Lisp packages configured with twist.nix

twist.el

This is a companion to twist.nix. You can use twist.nix without this Emacs Lisp package, but it improves the usability of Emacs with twist.

Features

• Enable hot reloading of Emacs Lisp packages

Configuration

Hot reloading

To enable hot reloading of Emacs Lisp packages, you first have to update your Nix configuration.

Set =exportManifest=​ option of twist to true:

emacsTwist {
  initFiles = [
    ./init.el
  ];
  lockDir = ./lock;
  ...
  # This is required to enable hot reloading
  exportManifest = true;
}

Set =programs.emacs-twist.createManifestFile=​ option of the home-manager module to true:

programs.emacs-twist = {
  Set user-emacs-directory
  directory = ".local/share/emacs";
  createInitFile = true;
  config = emacsConfig;
  # This is also required for hot reloading
  createManifestFile = true;
};

To detect updates of the configuration, enable twist-watch-mode:

(add-hook 'emacs-startup-hook #'twist-watch-mode)

Usage

Reloading packages

To reload updated packages, run twist-update command.