CHANGELOG.md

Change log

Unreleased

New features

• Add prelude-ai module: a thin wrapper around gptel for LLM-backed chat (Claude, GPT, Gemini, Ollama, etc.). Binds gptel-menu to C-c q. Backends and API keys are configured in personal config -- see the module documentation for examples.
• Add prelude-forge module: enables Forge on top of Magit so you can read and reply to GitHub/GitLab/Gitea pull requests and issues without leaving Emacs.
• Add prelude-eglot-booster module: speeds up Eglot via the emacs-lsp-booster wrapper. The Emacs side (eglot-booster) is auto-installed via package-vc-install when the booster binary is on PATH; otherwise the module no-ops.
• Add prelude-corfu module: a modern, lightweight in-buffer completion stack (corfu + cape) -- alternative to prelude-company. Pairs naturally with the vertico/orderless setup in prelude-vertico.
• Add prelude-apheleia module: enables Apheleia globally for async, flicker-free format-on-save (Prettier, Black, Ruff, gofmt, rustfmt, ...). Supersedes the per-language format hooks in modules like prelude-rust and prelude-go.

Changes

• Tidy up prelude-common-lisp: drop stale slime-autodoc-use-multiline-p setting (the variable was removed from upstream SLIME; modern autodoc honors eldoc-echo-area-use-multiline-p), set inferior-lisp-program to sbcl so M-x run-lisp works without SLIME, and add slime-quicklisp to slime-contribs for Quicklisp integration.

Bugs fixed

• Update prelude-helm to current upstream variable/function names: rename helm-google-suggest-use-curl-p to helm-net-prefer-curl (deprecated alias since helm 1.7.7), rename helm-split-window-in-side-p to helm-split-window-inside-p (deprecated alias since helm 2.8.6), drop helm-ff-file-name-history-use-recentf (removed from helm; behavior is now unconditional), and drop the C-c w binding to helm-wikipedia-suggest (function moved to a separate helm-wikipedia package).
• Drop C-c C-l binding to helm-comint-input-ring in prelude-helm-everywhere -- that command was removed from upstream helm.
• Replace stale erc-autoaway-use-emacs-idle setting in prelude-erc with (setq erc-autoaway-idle-method 'emacs) (the old variable was removed; idle source is now selected via erc-autoaway-idle-method).
• Rebind M-s m from removed consult-multi-occur to built-in multi-occur in prelude-vertico (consult dropped the wrapper in favor of the built-in command).
• #1450: Remove broken slime-complete-symbol-function setting in prelude-common-lisp (referenced an undefined slime-flex-completions symbol; the variable itself has been obsolete since 2015).
• Fix prelude-ocaml integration with neocaml: hook into neocaml-base-mode (so .mli files are covered), enable ocaml-eglot-mode properly, and call prelude-lsp-enable so the LSP server actually starts.
• Use ocaml-eglot-mode instead of the obsolete ocaml-eglot alias (renamed in ocaml-eglot 1.4.0).
• Add a temporary eglot-server-programs entry for neocaml so older neocaml versions still get ocamllsp started. Can be removed once neocaml >= 20260331 is widely available on MELPA.
• Drop M-g e and M-g f from prelude-vertico's consult bindings so they no longer shadow the avy bindings (avy-goto-word-0, avy-goto-line) set in core. Bind consult-compile-error / consult-flymake in your personal config if you want them.

2.1.0 (2026-03-29)

New features

• Add cmake-mode package to prelude-c.
• Set c-ts-mode-indent-style to k&r so tree-sitter C/C++ modes match the classic cc-mode indentation style.
• Add auto-mode-alist entries for Eask and Eldev build tool files in prelude-emacs-lisp.
• Add Super-based (s-) keybindings on macOS for smartparens structural editing commands (splice, slurp, barf, splice-killing).

Changes

• Switch smartparens from paredit to default keybinding set. This frees M-s (was sp-splice-sexp, shadowed search-map) and M-? (was sp-convolute-sexp, shadowed xref-find-references). Splice is now on M-D, convolute is unbound, splice-killing moves to C-M-<backspace> / C-M-<delete>.
• Convert all language modules to use-package: C, Clojure, Common Lisp, CSS, Dart, Elixir, Erlang, Emacs Lisp, F#, Go, Haskell, LaTeX, Lua, OCaml, Racket, Ruby, Rust, Scala, Scheme, SCSS, Web, YAML.
• Remove prelude-coffee module (CoffeeScript is no longer actively developed). The module file is kept as a deprecation stub so existing configs don't break.
• Remove dune and utop packages from prelude-ocaml (both are provided by neocaml out of the box).
• Load ocaml-eglot in prelude-ocaml only when prelude-lsp-client is set to eglot.
• Default to SBCL on all platforms in prelude-common-lisp (was Clozure CL on macOS).
• Disable slime-enable-evaluate-in-emacs by default in prelude-common-lisp (security risk).
• Add missing prelude-lsp-enable call in prelude-fsharp.
• Guard eglot-fsharp behind prelude-lsp-client check in prelude-fsharp.
• Use major-mode-remap-alist instead of defalias for cperl-mode in prelude-perl.
• Remove C-c C-l binding from prelude-lua (conflicts with Eglot prefix).
• Load company-auctex only when company is present in prelude-latex.
• Move Makefile configuration from prelude-c to prelude-programming (benefits all programming modules).
• Install dart-mode explicitly in prelude-dart instead of relying on auto-install.

Bugs fixed

• #1400: Fix M-s (search-map) and M-? (xref-find-references) being shadowed by smartparens paredit keybindings.

2.0.0 (2026-03-26)

New features

• Prelude now requires Emacs 29.1 or newer. This unlocks built-in tree-sitter, Eglot, use-package, and many other modern Emacs features.
• Add prelude-lsp-client user option to switch between Eglot (default, built-in) and lsp-mode as the LSP client. All language modules use the configured client automatically.
• Add tree-sitter support for C/C++, Go, Python, JavaScript, TypeScript (including TSX), Ruby, Elixir, Shell, YAML, and CSS. Tree-sitter modes are used automatically when the grammar is available, with graceful fallback to legacy modes.
• Add prelude-treesit-remap helper to safely remap modes to their tree-sitter equivalents, with proper guards for grammar availability.
• Add LSP support to Python, JavaScript, TypeScript, C/C++, Ruby, Elixir, Haskell, Lua, and Erlang modules.
• Add Eglot keybindings under C-c C-l prefix (rename, code actions, format, organize imports), consistent with lsp-mode bindings.
• Add prelude-vertico module. Vertico is a simpler alternative to ivy-mode and supersedes Selectrum.
• Add marginalia to prelude-vertico for rich annotations in the minibuffer.
• Add a Racket module.
• Add a Lua module.
• Add a F# module.
• Add a module to enable Literate Programming (prelude-literal-programming.el).
• PR 1432: Allow directories of custom Emacs Lisp files in personal/preload.
• Add prelude-projectile user option, allowing Projectile integration to be disabled.
• Add prelude-hippie-expand user option, allowing hippie-expand support to be disabled.
• #1421: Make it possible to configure the TypeScript format action using prelude-ts-format-action.
• #1354: Remove default C-- and C-+ keybindings to increase/decrease the font size.
• Enable pixel-scroll-precision-mode for smooth scrolling on graphical displays.
• Enable isearch-lazy-count for showing match counts during search and query-replace.
• Enable org-habits.
• Add org-capture binding (C-c c) and enable org-indent-mode by default.
• Neatly track TODO state changes in a drawer (LOGBOOK), thereby improving readability.
• Enable subword-mode in C, Dart, F#, LaTeX, OCaml, and Perl modules for better CamelCase navigation.
• Add indentation defaults and modern template file extensions (.vue, .svelte, .astro, etc.) to prelude-web.
• Auto-install racket-mode if needed.

Changes

• Modernize prelude-ocaml to use neocaml (tree-sitter), eglot, and ocaml-eglot instead of tuareg, merlin, and flycheck-ocaml.
• Modernize prelude-python to use LSP instead of anaconda-mode.
• Modernize prelude-js to use js-ts-mode and LSP instead of js2-mode.
• Modernize prelude-ts to use typescript-ts-mode and LSP instead of tide.
• Rename prelude-lsp module to prelude-lsp-mode for clarity. It is now loaded on demand only when prelude-lsp-client is set to lsp-mode.
• Remove prelude-selectrum module (Selectrum is unmaintained, use Vertico instead).
• Remove nlinum package in favor of built-in display-line-numbers-mode.
• Remove anzu package in favor of built-in isearch-lazy-count.
• Remove epl package in favor of built-in package-upgrade-all / package-upgrade.
• Remove alchemist from prelude-elixir (unmaintained since 2018).
• Remove go-projectile from prelude-go (unmaintained).
• Replace defadvice with modern define-advice / advice-add throughout.
• Replace deprecated point-at-eol with line-end-position in prelude-evil.
• Replace deprecated linum-mode ex command with display-line-numbers-mode in prelude-evil.
• Remove obsolete magit keymaps from prelude-evil (magit-commit-mode-map, magit-branch-manager-mode-map).
• Switch SLIME completion from slime-fuzzy to slime-flex in prelude-common-lisp.
• Use use-short-answers instead of fset hack for y/n prompts.
• Use built-in ansi-color-compilation-filter for compilation buffer colorization.
• Use built-in use-package (no longer installed as a package).
• Use use-package to defer loading of interactive packages, improving startup time.
• Remove redundant require calls to improve startup time.
• Remove C-x p binding to proced (conflicts with built-in project.el prefix).
• Bind C-x C-m to execute-extended-command instead of smex.
• Remove redundant addition to auto-mode-alist for Markdown (note: this reverts the default to markdown-mode instead of gfm-mode).
• Bind all essential avy commands to their recommended keybindings.
• Remove company-lsp.
• Replace yank-pop key-binding to counsel-yank-pop for ivy-mode.
• Replace prelude-go backend with lsp instead of unmaintained tools.
• Restore format-on-save for Go via gofmt-before-save.
• Use rust-analyzer as language server for prelude-rust and provide nicer syntax highlighting with tree-sitter.
• Add prelude-undo-tree custom variable: allows user disable undo-tree integration. Enabled by default to maintain backward-compatibility.
• Disable ERC module by default and remove Freenode reference.
• Use HTTPS for MELPA on all platforms.
• Guard set-fontset-font with display-graphic-p to avoid errors in terminal Emacs.
• Switch docs theme from ReadTheDocs to Material for MkDocs.
• CI now tests on multiple Emacs versions (29.x, 30.x).

Bugs fixed

• Fix hook variable name mismatch in prelude-fsharp (prelude-sharp-mode-hook → prelude-fsharp-mode-hook).
• Fix duplicate zlogin entry and wrong comment in prelude-shell.
• Fix wrong header comment in prelude-ocaml (said "Perl").
• Fix spurious (interactive) in prelude-ts-mode-defaults.
• Fix duplicate auto-mode-alist entries in prelude-racket.
• #1445: Fix prelude-rust failing to load due to tree-sitter dependency issue.
• Fix wrong hook name in prelude-rust.
• PR 1433: Remove a duplicate when call in modules/prelude-helm-everywhere.el causing an emacs init error when prelude-helm-everywhere is enabled.
• Fix company still being visible in the mode line.
• #1335: Workaround for which-key bug causing display issues in clients to emacs --daemon.
• Fix Edit on GitHub link in ReadTheDocs site.
• Fix fall back to sample prelude-modules.el not working if user has installed to non-default location.
• Stop requiring helm-config since upstream has removed the module.
• Turn off super-save in rust-mode to prevent severe hangs during autocomplete.
• Update prelude-dart.el to use lsp-dart-dap-setup instead of deprecated dap-dart-setup function.
• Fix stale references and broken config across modules.

1.1.0 (2021-02-14)

New features

• Enable nlinum-mode or display-line-numbers-mode by default. Can be disabled by setting prelude-minimalistic-ui to t.
• Enable site-wide installation for Prelude.
• Auto-installs julia-mode if needed.
• Auto-install adoc-mode for AsciiDoc files.
• Add the ag package. It provides a nice alternative to grep and has nice Projectile integration.
• Added additional configuration modules for WSL (prelude-wsl) and Windows (prelude-windows).
• Add prelude-selectrum module. Selectrum a simpler alternative to ivy-mode.

Changes

• #1292: Add prelude-python-mode-set-encoding-automatically defcustom inn prelude-python.el module with nil default value.
• #1278: Don't disable menu-bar-mode unless prelude-minimalistic-ui is enabled.
• #1277: Make it possible to disable the creation of Super-based keybindings via prelude-super-keybindings.
• Removed deprecated alias prelude-ensure-module-deps.
• Remove prelude-fullscreen, as these days people can use toggle-frame-fullscreen instead. (it was introduced in Emacs 24.4)
• Removed beacon-mode.
• Added transient/ to .gitignore.
• Fallback to sample/prelude-modules.el in the absence of a prelude-modules.el in one's personal folder.
• [Ruby] Don't auto-insert coding comments.
• Hide (via diminish) editorconfig-mode, super-save, company, abbrev and ivy in the modeline.
• Use lsp-workspace-restart function instead of deprecated lsp-restart-workspace.
• Bind all online search commands under C-c C-/ to avoid a conflict with counsel-git or magit-file-dispatch.
• Bound magit-file-mode to C-c g (it's also bound to C-c M-g if you decide to utilize this keybinding for something else.
• Added .cache/ and lsp-session* to .gitignore. These are generated by lsp.

Bugs fixed

• #1445: prelude-rust fails to load due to tree-sitter dependency issue
• #1302: C-a should be bound to org-beginning-of-line in org-mode buffers.

1.0.0 (2020-09-15)

Initial "stable" release after 9 years of development.