Inspired by Spacemacs and Doom Emacs. Most of the “aesthetic” parts of those distributions are available as plugins, so gluing together your own configuration isn’t too hard.
Featuring:
- straight.el for package management
- maximal use-package for package configuration
- maximal EVIL for vim comfort
Be multi-platform, as I jump between Linux, Windows, and WSL
Be as idiomatic as possible. Parts of this config have been copied and pasted from other places, but are rewritten/updated if needed to stay consistent and easy to read.
Every feature provided by use-package
is used over calling elisp functions. That means :custom
is preferred over setq
, :hook
over add-hook
, etc. where possible.
Minimal customization of packages we use, unless they misbehave. Try to document and rationalize any setting set thats not part of the package’s setup instructions.
Try to avoid “Not Invented Here” syndrome, use an existing package to do something instead of rolling our own.
Emacs startup times can be painful, if left uncontrolled. With a “basic” config like this one still resulting in multi-second startup times, its a frequent topic of debate. Distributions like doom-emacs
use fast startup times as one of the main selling points. Let’s try to pull in all the wisdom on how to keep our config simple yet fast.
In Emacs 27+, package initialization occurs before user-init-file
is loaded, but after early-init-file
. We handle package initialization, so we must prevent Emacs from doing it early!
;;; -*- lexical-binding: t; -*-
(defvar comp-deferred-compliation)
(setq comp-deferred-compilation t)
(setq package-enable-at-startup nil)
;; Resizing the Emacs frame can be a terribly expensive part of changing the
;; font. By inhibiting this, we easily halve startup times with fonts that are
;; larger than the system default.
(setq frame-inhibit-implied-resize t)
Prevent the glimpse of un-styled Emacs by disabling these UI elements early.
(menu-bar-mode -1)
(unless (and (display-graphic-p) (eq system-type 'darwin))
(push '(menu-bar-lines . 0) default-frame-alist))
(push '(tool-bar-lines . 0) default-frame-alist)
(push '(vertical-scroll-bars) default-frame-alist)
Following Doom-Emacs FAQ, we max the garbage collection threshold on startup, and reset it to the original value after.
;; max memory available for gc on startup
(defvar me/gc-cons-threshold 16777216)
(setq gc-cons-threshold most-positive-fixnum
gc-cons-percentage 0.6)
(add-hook 'emacs-startup-hook
(lambda ()
(setq gc-cons-threshold me/gc-cons-threshold
gc-cons-percentage 0.1)))
;; max memory available for gc when opening minibuffer
(defun me/defer-garbage-collection-h ()
(setq gc-cons-threshold most-positive-fixnum))
(defun me/restore-garbage-collection-h ()
;; Defer it so that commands launched immediately after will enjoy the
;; benefits.
(run-at-time
1 nil (lambda () (setq gc-cons-threshold me/gc-cons-threshold))))
(add-hook 'minibuffer-setup-hook #'me/defer-garbage-collection-h)
(add-hook 'minibuffer-exit-hook #'me/restore-garbage-collection-h)
(setq garbage-collection-messages t)
We also set the file-name-handler-alist
to an empty list, and reset it after Emacs has finished initializing.
(defvar me/-file-name-handler-alist file-name-handler-alist)
(setq file-name-handler-alist nil)
(add-hook 'emacs-startup-hook
(lambda ()
(setq file-name-handler-alist me/-file-name-handler-alist)))
(setq site-run-file nil)
(setq inhibit-compacting-font-caches t)
Optimizations for improving I/O performance. Increase max bytes read from a sub-process in a single op (Emacs 27+)
(when (boundp 'read-process-output-max)
;; 1MB in bytes, default 4096 bytes
(setq read-process-output-max 1048576))
straight.el is used to download packages for us from all over the web. It stores them all in their respective git folders in .emacs.d/straight
, which makes debugging, and contributing fixes back upstream as easy as possible.
First, we configure some settings for staight.el
to better integrate with use-package
. use-package is a nice and consistent way to declare packages and their respective configs.
(setq straight-use-package-by-default t
use-package-always-defer t
straight-cache-autoloads t
straight-vc-git-default-clone-depth 1
straight-check-for-modifications '(find-when-checking)
package-enable-at-startup nil
vc-follow-symlinks t)
Then, we want to enable debugging whenever we encounter an error.
(setq debug-on-error t)
Now, let’s fetch straight.el
.
(defvar bootstrap-version)
(let ((bootstrap-file
(expand-file-name "straight/repos/straight.el/bootstrap.el" user-emacs-directory))
(bootstrap-version 5))
(unless (file-exists-p bootstrap-file)
(with-current-buffer
(url-retrieve-synchronously
"https://raw.githubusercontent.com/raxod502/straight.el/develop/install.el"
'silent 'inhibit-cookies)
(goto-char (point-max))
(eval-print-last-sexp)))
(load bootstrap-file nil 'nomessage))
(setq vc-follow-symlinks 'ask) ; restore default
Let’s load an optional package which gives us some convenience functions, like straight-x-clean-unused-repo
to remove any packages we don’t have configured anymore.
(require 'straight-x)
Now, let’s install use-package
.
(straight-use-package 'use-package)
We use esup and benchmark-init-el to keep tabs on our startup speed.
(use-package esup
:demand t
:commands esup)
(use-package benchmark-init
:demand t
:straight (:host github :repo "kekeimiku/benchmark-init-el")
:hook (after-init . benchmark-init/deactivate))
Also let’s print a message to the *messages*
buffer with the total startup time.
(add-hook
'emacs-startup-hook
(lambda ()
(message "Emacs ready in %s with %d garbage collections."
(format
"%.2f seconds"
(float-time
(time-subtract after-init-time before-init-time)))
gcs-done)))
(use-package gcmh
:demand t
:config
(gcmh-mode 1))
(provide 'early-init)
Make elisp in this file behave like we expect these days. Everyone has this set, but no one explains why.
In non-elisp speak, it adds proper scoping and “closure” behaviour to variables.This Emacswiki article explains it well.
;;; config.el -*- lexical-binding: t ; eval: (view-mode -1) -*-
Enable view-mode
, which both makes the file read-only (as a reminder
that init.el
is an auto-generated file, not supposed to be edited),
and provides some convenient key bindings for browsing through the
file.
Let’s define some constants we use throughout our config.
;; environment
(defconst *is-windows* (eq system-type 'windows-nt))
(defconst *is-unix* (not *is-windows*))
;; fonts
(defconst *mono-font-family*
(if *is-windows* "JetBrainsMono NF" "GoMono Nerd Font"))
(defconst *mono-font-height*
(if *is-windows* 90 90))
(defconst *serif-font-family*
(if *is-windows* "Georgia" "IBM Plex Serif"))
(defconst *serif-font-height*
(if *is-windows* 110 110))
(defconst *project-dir* (expand-file-name "~/git"))
Essentially what vim-sensible does, but we use better-defaults in emacs. But it doesn’t do everything, so we need to help it out.
(use-package better-defaults
:straight (better-defaults :type git :host nil :repo "https://git.sr.ht/~technomancy/better-defaults")
:demand t)
(setq default-directory "~/"
;; always follow symlinks when opening files
vc-follow-symlinks t
;; overwrite text when selected, like we expect.
delete-seleciton-mode t
;; quiet startup
inhibit-startup-message t
initial-scratch-message nil
;; hopefully all themes we install are safe
custom-safe-themes t
;; simple lock/backup file management
create-lockfiles nil
backup-by-copying t
delete-old-versions t
;; when quiting emacs, just kill processes
confirm-kill-processes nil
;; ask if local variables are safe once.
enable-local-variables t
;; life is too short to type yes or no
use-short-answers t
;; clean up dired buffers
dired-kill-when-opening-new-dired-buffer t)
;; use human-readable sizes in dired
(setq-default dired-listing-switches "-alh")
;; always highlight code
(global-font-lock-mode 1)
;; refresh a buffer if changed on disk
(global-auto-revert-mode 1)
;; save window layout & buffers
;; (setq desktop-restore-eager 5)
;; (desktop-save-mode 1)
Emacs is very conservative about assuming encoding. Everything is utf-8 these days, lets have that as the default.
(prefer-coding-system 'utf-8)
(set-default-coding-systems 'utf-8)
(set-terminal-coding-system 'utf-8)
(set-keyboard-coding-system 'utf-8)
(set-selection-coding-system 'utf-8)
(set-file-name-coding-system 'utf-8)
(set-clipboard-coding-system 'utf-8)
(if *is-windows*
(set-w32-system-coding-system 'utf-8))
(set-buffer-file-coding-system 'utf-8)
no-littering teaches Emacs to not leave it’s files everywhere, and just keep them neatly in .emacs.d
where they don’t bother anyone.
We also set custom-file
to be within one of these new nice directories, so Emacs doesn’t keep chaging init.el
and messing with our git workflow.
(use-package no-littering
:demand t
:config
(setq
auto-save-file-name-transforms
`((".*" ,(no-littering-expand-var-file-name "auto-save/") t)))
(setq custom-file (no-littering-expand-etc-file-name "custom.el"))
(when (file-exists-p custom-file)
(load custom-file)))
which-key pops up a nice window whenever we hesitate about a keyboard shortcut, and shows all the possible keys we can press. Popularized by Spacemacs and Doom-Emacs, we can now configure absurd key combinations, forget about them, and then be delighted to discover them again!
(use-package which-key
:demand t
:after evil
:custom
(which-key-allow-evil-operators t)
(which-key-show-remaining-keys t)
(which-key-sort-order 'which-key-prefix-then-key-order)
:config
(which-key-mode 1)
(which-key-setup-minibuffer)
(set-face-attribute
'which-key-local-map-description-face nil :weight 'bold))
EVIL is vim emulation in Emacs. There are a number of other evil packages which add vim-like bindings to various modes.
(use-package undo-tree
:demand t
:config
(global-undo-tree-mode))
(use-package evil
:demand t
:after undo-tree
:init
(setq evil-want-integration t
evil-want-keybinding nil
evil-want-C-u-scroll t
evil-want-Y-yank-to-eol t
evil-split-window-below t
evil-vsplit-window-right t
evil-respect-visual-line-mode t
evil-undo-system 'undo-tree)
:config
(evil-mode 1))
(use-package evil-collection
:demand t
:after evil
:config
(evil-collection-init))
(use-package evil-commentary
:demand t
:after evil
:config
(evil-commentary-mode 1))
(use-package evil-surround
:demand t
:after evil
:config
(global-evil-surround-mode 1))
(use-package evil-org
:demand t
:after evil org
:hook (org-mode . evil-org-mode)
:config
(add-hook 'evil-org-mode-hook 'evil-org-set-key-theme)
(require 'evil-org-agenda)
(evil-org-agenda-set-keys))
general.el is a wrapper around Emacs key-binding mechanisms to make them easier to use. It integrates with use-package, evil, and which-key.
We will define two “leader maps”, similar to vim’s <leader>
and <localleader>
that we will use to bind global and major-mode-specific keybindings. This is how we’re kind of like
(use-package general
:demand t
:config
(general-evil-setup t)
(general-create-definer leader-def
:states '(normal motion emacs)
:keymaps 'override
:prefix "SPC"
:non-normal-prefix "C-SPC")
(leader-def
"" '(:ignore t :wk "leader")
"f" '(:ignore t :wk "file")
"c" '(:ignore t :wk "checks")
"t" '(:ignore t :wk "toggle")
"b" '(:ignore t :wk "buffer")
"bd" 'kill-this-buffer
"bn" 'next-buffer
"bp" 'previous-buffer
"bx" 'kill-buffer-and-window
"s" '(:ignore t :wk "straight")
"sf" 'straight-x-fetch-all
"sp" 'straight-x-pull-all
"sr" 'straight-remove-unused-repos
"ss" 'straight-get-recipe)
(general-create-definer localleader-def
:states '(normal motion emacs)
:keymaps 'override
:prefix "SPC m"
:non-normal-prefix "C-SPC m")
(localleader-def "" '(:ignore t :wk "mode")))
(add-hook 'compilation-filter-hook 'ansi-color-compilation-filter)
A good-looking tool is a pleasure to work with. Here, we try to tweak all the dials Emacs gives us to make it pretty and A E S T H E T I C
.
(setq ring-bell-function 'ignore ; no bell
;; better scrolling
scroll-conservatively 101
scroll-preserve-screen-position 1
mouse-wheel-follow-mouse t
pixel-scroll-precision-use-momentum t)
(setq-default line-spacing 1)
;; highlight the current line
(global-hl-line-mode t)
;; Add padding inside buffer windows
(setq-default left-margin-width 2
right-margin-width 2)
(set-window-buffer nil (current-buffer)) ; Use them now.
;; Add padding inside frames (windows)
(add-to-list 'default-frame-alist '(internal-border-width . 8))
(set-frame-parameter nil 'internal-border-width 8) ; Use them now
;; fix color display when loading emacs in terminal
(defun enable-256color-term ()
(interactive)
(load-library "term/xterm")
(terminal-init-xterm))
(unless (display-graphic-p)
(if (string-suffix-p "256color" (getenv "TERM"))
(enable-256color-term)))
We will load all the themes. We need to :defer
them, to prevent each theme getting loaded upon init, and flashing emacs and conflicting with each other.
(use-package leuven-theme
:defer t)
(use-package vivid-theme
:straight (:host github :repo "websymphony/vivid-theme")
:defer t)
(use-package doom-themes
:defer t
:config
(doom-themes-visual-bell-config)
(doom-themes-treemacs-config)
(doom-themes-org-config)
(doom-themes-set-faces nil
;; extending faces breaks orgmode collapsing for now
'(org-block-begin-line :extend nil)
'(org-block-end-line :extend nil)
;; different sized headings are nice.
'(outline-1 :height 1.3)
'(outline-2 :height 1.1)
'(outline-3 :height 1.0)))
(use-package modus-themes
:defer t
:custom
(modus-themes-italic-constructs t)
(modus-themes-intense-markup t)
(modus-themes-mode-line '(borderless moody))
(modus-themes-tabs-accented t)
(modus-themes-completions
'((matches . (extrabold background intense))
(selection . (semibold accented intense))
(popup . (accented))
(t . (extrabold intense))))
(modus-themes-org-blocks 'tinted-background)
(modus-themes-mixed-fonts t)
(modus-themes-headings
'((1 . (rainbow))
(2 . (rainbow))
(3 . (rainbow))
(t . (monochrome)))))
(defun me/init-theme ()
(load-theme 'modus-operandi t))
(add-hook 'emacs-startup-hook #'me/init-theme)
The unicode-fonts package helps Emacs use the full range of unicode characters provided by most fonts.
We set a regular font and a variable-pitch
one, the latter is used by mixed-pitch-mode
to render regular text with a proportional font.
(use-package persistent-soft
:demand t)
(use-package unicode-fonts
:demand t
:after persistent-soft
:config
(unicode-fonts-setup)
(custom-set-faces
`(default ((t (:family ,*mono-font-family*
:height ,*mono-font-height*))))
`(variable-pitch ((t (:family ,*serif-font-family*
:height ,*serif-font-height*))))))
all-the-icons allows emacs to show pretty icons anywhere we want.
We pair it with all-the-icons-dired to show them in dired
, treemacs-all-the-icons to show them in treemacs
, and all-the-icons-completion for completion sources.
(use-package all-the-icons
:demand t)
(use-package all-the-icons-dired
:defer 1
:after all-the-icons
:hook (dired-mode . all-the-icons-dired-mode))
(use-package treemacs-all-the-icons
:defer 1
:after all-the-icons treemacs
:config
(treemacs-load-theme "all-the-icons"))
(use-package all-the-icons-completion
:defer 1
:after all-the-icons
:config
(add-hook 'marginalia-mode-hook
#'all-the-icons-completion-marginalia-setup)
(all-the-icons-completion-mode 1))
emacs-dashboard adds a nice startup screen, showing recent files, projectes, etc.
(use-package dashboard
:demand t
:after all-the-icons projectile
:if (< (length command-line-args) 2)
:custom
;; show in `emacsclient -c`
(initial-buffer-choice #'(lambda () (get-buffer-create "*dashboard*")))
(dashboard-startup-banner 'logo)
(dashboard-set-heading-icons t)
(dashboard-set-file-icons t)
(dashboard-center-content t)
(dashboard-items '((recents . 10)
(projects . 5)
(bookmarks . 5)))
:config
(dashboard-setup-startup-hook))
doom-modeline provides a clean and simple modeline (bottom bar) for each buffer. We pair it with the minions minor mode to collect all minor modes into a single menu. anzu is used to show the number of matches when we search in a file.
(use-package anzu
:defer 1
:after isearch
:config
(global-anzu-mode 1))
(use-package minions
:defer 1
:config
(minions-mode 1))
(use-package doom-modeline
:demand t
:custom
(inhibit-compacting-font-caches t)
(doom-modeline-height 28)
;; 1 minor mode will be shown thanks to minions
(doom-modeline-minor-modes t)
(doom-modeline-hud t)
:config
(doom-modeline-mode 1))
centaur-tabs add tabs to the top of the window for emacs. It might sound crazy, but they are useful to keep an eye on which buffers you have open, especially when you jump between projects.
Out of the box they come configured ok, but not perfect. We configure the tabs to group by project, and hide/show them for more buffers.
(use-package centaur-tabs
:disabled t
:defer 1
:after all-the-icons
:general
(:states 'normal
"gt" 'centaur-tabs-forward
"gT" 'centaur-tabs-backward)
(leader-def
"tg" 'centaur-tabs-toggle-groups)
:hook
(dashboard-mode . centaur-tabs-local-mode)
(term-mode . centaur-tabs-local-mode)
(calendar-mode . centaur-tabs-local-mode)
(org-agenda-mode . centaur-tabs-local-mode)
(helpful-mode . centaur-tabs-local-mode)
:init
(setq centaur-tabs-enable-key-bindings t)
:custom
(centaur-tabs-style "bar")
(centaur-tabs-set-icons t)
(centaur-tabs-set-modified-marker t)
(centaur-tabs-height 28)
(centaur-tabs-gray-out-icons 'buffer)
(centaur-tabs-modified-marker "")
(uniquify-separator "/")
(uniquify-buffer-name-style 'forward)
:config
(centaur-tabs-headline-match)
(centaur-tabs-enable-buffer-reordering)
(centaur-tabs-mode t)
(centaur-tabs-change-fonts *mono-font-family* *mono-font-height*)
(defun me/after-theme (&rest _args)
(centaur-tabs-init-tabsets-store)
(centaur-tabs-display-update)
(centaur-tabs-headline-match))
(advice-add 'enable-theme :after #'me/after-theme)
(defun centaur-tabs-buffer-groups ()
"`centaur-tabs-buffer-groups' control buffers' group rules.
Group centaur-tabs with mode if buffer is derived from `eshell-mode' `emacs-lisp-mode' `dired-mode' `org-mode' `magit-mode'.
All buffer name start with * will group to \"Emacs\".
Other buffer group by `centaur-tabs-get-group-name' with project name."
(list
(cond
;; ((not (eq (file-remote-p (buffer-file-name)) nil))
;; "Remote")
((or (string-equal "*" (substring (buffer-name) 0 1))
(memq major-mode '(magit-process-mode
magit-status-mode
magit-diff-mode
magit-log-mode
magit-file-mode
magit-blob-mode
magit-blame-mode)))
"Emacs")
((derived-mode-p 'dired-mode)
"Dired")
((memq major-mode '(helpful-mode
help-mode))
"Help")
((memq major-mode '(org-agenda-clockreport-mode
org-agenda-mode
org-beamer-mode
org-src-mode
org-indent-mode
org-bullets-mode
org-cdlatex-mode
org-agenda-log-mode
diary-mode))
"OrgMode")
(t
(or (concat "Project: " (projectile-project-name))
(centaur-tabs-get-group-name (current-buffer))))))))
Always redraw immediately when scrolling, more responsive and doesn’t hang! Sourced from http://emacs.stackexchange.com/a/31427/2418
(setq fast-but-imprecise-scrolling t
jit-lock-defer-time 0)
fast-scroll “works by temporarily disabling font-lock and switching to a barebones mode-line, until you stop scrolling (at which point it re-enables)”. It only does this when scrolling super fast, to keep everything responsive.
(use-package fast-scroll
:defer 1
:hook
(fast-scroll-start . (lambda () (flycheck-mode -1)))
(fast-scroll-end . (lambda () (flycheck-mode 1)))
:config
(fast-scroll-config)
(fast-scroll-mode 1))
visual-fill-column wraps lines at fill-column
, and makes it easier to read long lines of code. It is preferred over the built-in visual-line-mode
because it doesn’t break words.
(use-package visual-fill-column
:defer 1
:hook (org-src . visual-fill-column-mode)
:custom
(visual-line-fringe-indicators
'(left-curly-arrow right-curly-arrow))
(split-window-preferred-function
'visual-fill-column-split-window-sensibly)
:config
(advice-add 'text-scale-adjust
:after #'visual-fill-column-adjust)
(global-visual-fill-column-mode 1)
(global-visual-line-mode 1))
mixed-pitch allows us to use proportional fonts to display text that isn’t code, and make files more readable.
(use-package mixed-pitch
:after all-the-icons
:defer 1
:commands mixed-pitch-mode
:custom
(mixed-pitch-set-height t))
;; :hook (text-mode . mixed-pitch-mode))
(use-package ligature
:straight (:host github :repo "mickeynp/ligature.el")
:defer 1
:config
(ligature-set-ligatures 't '("www"))
(ligature-set-ligatures
'prog-mode
'("-->" "//" "/**" "/*" "*/" "<!--" ":=" "->>" "<<-" "->" "<-"
"<=>" "==" "!=" "<=" ">=" "=:=" "!==" "&&" "||" "..." ".."
"|||" "///" "&&&" "===" "++" "--" "=>" "|>" "<|" "||>" "<||"
"|||>" "<|||" ">>" "<<" "::=" "|]" "[|" "{|" "|}"
"[<" ">]" ":?>" ":?" "/=" "[||]" "!!" "?:" "?." "::"
"+++" "??" "###" "##" ":::" "####" ".?" "?=" "=!=" "<|>"
"<:" ":<" ":>" ">:" "<>" "***" ";;" "/==" ".=" ".-" "__"
"=/=" "<-<" "<<<" ">>>" "<=<" "<<=" "<==" "<==>" "==>" "=>>"
">=>" ">>=" ">>-" ">-" "<~>" "-<" "-<<" "=<<" "---" "<-|"
"<=|" "/\\" "\\/" "|=>" "|~>" "<~~" "<~" "~~" "~~>" "~>"
"<$>" "<$" "$>" "<+>" "<+" "+>" "<*>" "<*" "*>" "</>" "</" "/>"
"<->" "..<" "~=" "~-" "-~" "~@" "^=" "-|" "_|_" "|-" "||-"
"|=" "||=" "#{" "#[" "]#" "#(" "#?" "#_" "#_(" "#:" "#!" "#="
"&="))
(global-ligature-mode t))
solaire-mode darkens non-important buffers, to help you focus on what matters.
;; A more complex, more lazy-loaded config
(use-package solaire-mode
:defer 1
:hook
;; Ensure solaire-mode is running in all solaire-mode buffers
(change-major-mode . turn-on-solaire-mode)
;; ...if you use auto-revert-mode, this prevents solaire-mode from turning
;; itself off every time Emacs reverts the file
(after-revert . turn-on-solaire-mode)
;; To enable solaire-mode unconditionally for certain modes:
(ediff-prepare-buffer . solaire-mode)
:custom
(solaire-mode-auto-swap-bg t)
:config
(solaire-global-mode +1))
helpful makes a better Emacs *help*
buffer, with colors and contextual information.
(use-package helpful
:defer 1
:general
(leader-def
"h" '(:ignore t :wk "help")
"hh" 'helpful-symbol
"hf" 'helpful-function
"hv" 'helpful-variable
"hk" 'helpful-key
"ho" 'helpful-at-point)
:config
(add-to-list 'display-buffer-alist
'("*[Hh]elp"
(display-buffer-reuse-mode-window
display-buffer-pop-up-window))))
info-colors adds pretty Info colors.
(use-package info-colors
:defer 1
:config
(add-hook 'Info-selection-hook 'info-colors-fontify-node))
restart-emacs teaches Emacs to restart itself. I added a me/reload-init
command as well to just reload the init.el
file without a full restart.
(defun me/reload-init ()
"Reload init.el."
(interactive)
(message "Reloading init.el...")
(load user-init-file nil 'nomessage)
(message "Reloading init.el... done."))
(use-package restart-emacs
:commands restart-emacs
:general
(leader-def
"q" '(:ignore t :wk "exit emacs")
"qR" 'restart-emacs
"qn" 'restart-emacs-start-new-emacs
"qr" 'me/reload-init))
prescient.el teaches company
better sorting and filtering.
(use-package prescient
:defer 1
:config
(prescient-persist-mode 1))
flycheck gathers syntax errors and warnings on-the-fly. We use flycheck-posframe to show them if the cursor is on a flycheck warning.
(use-package flycheck
:defer 1
:init
(global-flycheck-mode t))
(use-package flycheck-posframe
:defer 1
:after flycheck
:hook (flycheck-mode . flycheck-posframe-mode)
:config
(flycheck-posframe-configure-pretty-defaults)
(add-hook 'flycheck-posframe-inhibit-functions #'company--active-p)
(add-hook 'flycheck-posframe-inhibit-functions #'evil-insert-state-p)
(add-hook 'flycheck-posframe-inhibit-functions #'evil-replace-state-p))
apheleia knows about all the different formatters for different languuages, and tries to run them if they are installed.
(use-package apheleia
:straight (:host github :repo "raxod502/apheleia")
:defer 1
:config
(apheleia-global-mode +1))
company-mode gives us the standard dropdown as-you-type of modern IDEs.
(use-package company
:defer 1
:config
(global-company-mode 1))
(use-package company-prescient
:defer 1
:after company prescient
:config
(company-prescient-mode 1))
(use-package company-posframe
:defer 1
:after company
:custom
(company-posframe-quickhelp-delay nil)
:config
(company-posframe-mode 1))
magit is a magic UI for dealing with git. The keybinds are intuitive, and it pops up suggestion a-la which-key
if you aren’t sure what button to press next.
(use-package magit
:commands magit
:general
(leader-def
"g" '(:ignore t :wk "git")
"gs" '(magit :wk "git status")
"gg" '(magit :wk "git status"))
:custom
(magit-repository-directories `((,*project-dir* . 3)))
:config
;; speed up magit for large repos
(dir-locals-set-class-variables 'huge-git-repository
'((magit-status-mode
. ((eval . (magit-disable-section-inserter 'magit-insert-tags-header))))))
;; clasify by repo-name as detected by magit.
;; .dir-locals.el isn't portable across machines.
(let ((large-dirs '("nixpkgs")))
(dolist
(dir large-dirs)
(dir-locals-set-directory-class
(cdr (assoc dir (magit-repos-alist)))
'huge-git-repository))))
We pair it with magit-todos which shows any TODO
, FIXME
, XXX
, BUG
, etc. comments in the codebase.
(use-package magit-todos
:after magit
:commands magit-todos-list magit-todos-mode
:general
(leader-def
"gt" 'magit-todos-list)
:init
(if *is-windows* (setq magit-todos-nice nil)))
magit-delta improves the coloring of diffs in magit using delta.
(use-package magit-delta
:if *is-unix*
:after magit
:commands magit-delta-mode
:hook (magit-mode . magit-delta-mode))
projectile teaches Emacs to be aware of different ways a “project” folder can be recognized, and enables easy jumping and using of multiple projects in the same instance of emacs.
(defun me/expand-git-project-dirs (root)
"Return a list of all project directories 2 levels deep in ROOT.
Given my git projects directory ROOT, with a layout like =git/{hub,lab}/<user>/project=, return a list of 'user' directories that are part of the ROOT."
(mapcan #'(lambda (d) (cddr (directory-files d t)))
(cddr (directory-files root t))))
(use-package projectile
:demand t
:general
(leader-def
"p" '(:ignore t :wk "project")
"pP" 'projectile-switch-project
"pd" 'projectile-dired
"pb" 'projectile-switch-to-buffer
"pf" 'projectile-find-file
"p/" 'projectile-ripgrep)
:custom
(projectile-completion-system 'default)
(projectile-enable-caching t)
(projectile-sort-order 'recently-active)
(projectile-indexing-method (if *is-unix* 'hybrid 'native))
(projectile-project-search-path `((,*project-dir* . 3)))
:config
(projectile-save-known-projects)
(projectile-mode +1))
diff-hl shows uncommitted git changes on left side of the buffer.
(use-package diff-hl
:defer 1
:hook
(dired-mode . diff-hl-dired-mode-unless-remote)
:config
(global-diff-hl-mode 1))
treemacs is a sidebar tree file explorer of the current directory/project.
evil
, projectile
, and magit
integration is enabled.
(use-package treemacs
:defer 2
:commands treemacs treemacs-find-file
:general
(leader-def
"tt" 'treemacs
"tf" 'treemacs-find-file))
(use-package treemacs-evil
:defer 1
:after treemacs evil)
(use-package treemacs-projectile
:defer 1
:after treemacs projectile)
(use-package treemacs-magit
:defer 1
:after treemacs-magit)
(use-package company-fish
:defer 1
:if (executable-find "fish")
:straight (:host github :repo "CeleritasCelery/company-fish")
:after company
:hook
(shell-mode . company-mode)
(eshell-mode . company-mode)
:config
(add-to-list 'company-backends 'company-fish))
(use-package eshell-syntax-highlighting
:defer 1
:straight (:host github :repo "akreisher/eshell-syntax-highlighting")
:after esh-mode
:config
(eshell-syntax-highlighting-global-mode 1))
(use-package em-smart
:defer 1
:straight (:type built-in)
:custom
(eshell-where-to-jump 'begin)
(eshell-review-quick-commands nil)
(eshell-smart-space-goes-to-end t))
(use-package eterm-256color
:hook (term-mode . eterm-256color-mode))
(defun me/disable-global-hl-line-mode ()
(global-hl-line-mode -1))
(use-package vterm
:straight nil
:commands vterm vterm-other-window
:hook (vterm-mode . #'me/disable-global-hl-line-mode)
:custom
(vterm-term-environment-variable "eterm-color")
:config
(remove-hook 'vterm-mode-hook 'vterm))
(use-package multi-vterm
:commands
multi-vterm
multi-vterm-next
multi-vterm-prev
multi-vterm-dedicated-toggle
multi-vterm-project)
(leader-def "pt" 'multi-vterm-dedicated-toggle)
(use-package pcmpl-args)
(use-package lsp-mode
:defer 1
:commands lsp lsp-deferred
:hook
(prog-mode . lsp-deferred)
(lsp-mode . lsp-enable-which-key-integration)
:init
(setq lsp-completion-provider :capf
lsp-keymap-prefix nil)
:general
(local-leader-def
:keymaps 'lsp-mode-map
"l" '(lsp-command-map :wk "LSP")))
(use-package company-lsp
:after company lsp-mode
:config
(add-to-list 'company-backends 'company-lsp))
vertico is a replacement/improvement of emacs’ default icomplete
. It provides a pop-up menu to narrow down a list of choices.
(use-package emacs
:init
;; Add prompt indicator to `completing-read-multiple'.
;; We display [CRM<separator>], e.g., [CRM,] if the separator is a comma.
(defun crm-indicator (args)
(cons (format "[CRM%s] %s"
(replace-regexp-in-string
"\\`\\[.*?]\\*\\|\\[.*?]\\*\\'" ""
crm-separator)
(car args))
(cdr args)))
(advice-add #'completing-read-multiple :filter-args #'crm-indicator)
;; Do not allow the cursor in the minibuffer prompt
(setq minibuffer-prompt-properties
'(read-only t cursor-intangible t face minibuffer-prompt))
(add-hook 'minibuffer-setup-hook #'cursor-intangible-mode)
;; Emacs 28: Hide commands in M-x which do not work in the current mode.
(setq read-extended-command-predicate
#'command-completion-default-include-p)
;; Enable recursive minibuffers
(setq enable-recursive-minibuffers t))
(use-package savehist
:demand t
:config
(savehist-mode))
(use-package vertico
:demand t
:custom
(vertico-resize t)
(vertico-cycle t)
:config
(vertico-mode))
(use-package icomplete
:custom
(read-file-name-completion-ignore-case t)
(read-buffer-completion-ignore-case t)
(completion-ignore-case t)
(completion-category-defaults nil)
(completion-category-overrides
'((file (styles basic partial-completion))))
(completion-group t)
(completions-group-format
(concat
(propertize " " 'face 'completions-group-separator)
(propertize " %s " 'face 'completions-group-title)
(propertize " " 'face 'completions-group-separator
'display '(space :align-to right)))))
orderless teaches icomplete to match mutliple patterns in any order.
(use-package orderless
:demand t
:custom
(completion-styles '(orderless))
:config
(defun prefix-if-tilde (pattern _index _total)
(when (string-suffix-p "~" pattern)
`(orderless-prefixes . ,(substring pattern 0 -1))))
(defun regexp-if-slash (pattern _index _total)
(when (string-prefix-p "/" pattern)
`(orderless-regexp . ,(substring pattern 1))))
(defun literal-if-equal (pattern _index _total)
(when (string-suffix-p "=" pattern)
`(orderless-literal . ,(substring pattern 0 -1))))
(defun without-if-bang (pattern _index _total)
(cond
((equal "!" pattern)
'(orderless-literal . ""))
((string-prefix-p "!" pattern)
`(orderless-without-literal . ,(substring pattern 1)))))
(setq orderless-matching-styles '(orderless-flex))
(setq orderless-style-dispatchers
'(prefix-if-tilde
regexp-if-slash
literal-if-equal
without-if-bang)))
marginalia adds annotations to minibuffer completions
(use-package marginalia
:defer 1
:config
(marginalia-mode 1))
consult provides fancy commands for icomplete
(use-package consult
:defer 1
:general
(leader-def
"ff" 'find-file
"fr" 'consult-recent-file
"bb" 'consult-buffer
"tc" 'consult-theme
"/" 'consult-ripgrep
"g/" 'consult-git-grep)
:custom
(consult-project-root-function #'projectile-project-root)
(consult-narrow-key "<"))
(use-package consult-projectile
:after consult projectile
:demand t
:straight (consult-projectile :type git :host gitlab :repo "OlMon/consult-projectile" :branch "master")
:general
(leader-def
"pp" 'consult-projectile))
(use-package consult-flycheck
:after (consult flycheck)
:demand t
:general
(leader-def
"ee" 'consult-flycheck))
;; (use-package consult-lsp
;; :straight (consult-lsp :type git :host github :repo "gagbo/consult-lsp" :protocol ssh)
;; :commands (consult-lsp-symbols consult-lsp-diagnostics consult-lsp-file-symbols)
;; :config (define-key lsp-mode-map [remap xref-find-apropos] #'consult-lsp-symbols))
embark lets us capture minibuffer output in a buffer, and act on items/contexts. Kind of like a right-click.
(use-package embark
:after marginalia
:demand t
:custom
(prefix-help-command #'embark-prefix-help-command)
:general
(leader-def
"hm" 'embark-bindings-in-keymap
"hM" 'embark-bindings)
:config
(defvar-keymap embark-straight-map
:doc "Keymap actions for straight.el"
:parent embark-general-map
"u" #'straight-visit-package-website
"r" #'straight-get-recipe
"i" #'straight-use-package
"c" #'straight-check-package
"F" #'straight-pull-package
"f" #'straight-fetch-package
"p" #'straight-push-package
"n" #'straight-normalize-package
"m" #'straight-merge-package)
(add-to-list 'embark-keymap-alist '(straight . embark-straight-map))
(add-to-list 'marginalia-prompt-categories '("recipe\\|package" . straight)))
(use-package embark-consult
:after (embark consult)
:demand t
:hook
(embark-collect-mode . consult-preview-at-point-mode))
corfu is a minimalist package to compliment completion-in-region
.
(use-package corfu
:straight (corfu :files (:defaults "extensions/*"))
:after prescient
:custom
(tab-always-indent 'complete)
:init
(global-corfu-mode)
(defun corfu-enable-always-in-minibuffer ()
"Enable Corfu in the minibuffer if Vertico/Mct are not active."
(unless (or (bound-and-true-p mct--active)
(bound-and-true-p vertico--input))
(setq-local corfu-auto nil) ;; Disable auto completion
(setq-local corfu-echo-delay nil ;; Disable automatic echo and popup
corfu-popupinfo-delay nil)
(corfu-mode 1)))
(add-hook 'minibuffer-setup-hook #'corfu-enable-always-in-minibuffer 1))
(use-package corfu-history
:straight nil
:after (corfu savehist)
:commands corfu-history-mode
:init
(add-to-list 'savehist-additional-variables 'corfu-history)
(corfu-history-mode 1))
(use-package corfu-echo
:straight nil
:after corfu
:commands corfu-echo-mode
:init
(corfu-echo-mode 1))
(use-package corfu-popupinfo
:straight nil
:after corfu
:commands corfu-popupinfo-mode
:init
(corfu-popupinfo-mode 1))
(use-package kind-all-the-icons
:straight
(kind-all-the-icons :type git :host github
:repo "Hirozy/kind-all-the-icons")
:if (display-graphic-p)
:after corfu
:config
(add-to-list 'corfu-margin-formatters #'kind-all-the-icons-margin-formatter))
devdocs-broswer loads devdocs.io documentation inside eww
, and caches them for offline reading.
(use-package devdocs-browser)
Emacs has some cool features built-in that make editing text nice. Let’s turn them on.
;; treat camel-cased words as individual words.
(add-hook 'prog-mode-hook 'subword-mode)
;; don't assume sentences end with two spaces after a period.
(setq sentence-end-double-space nil)
;; show matching parens
(show-paren-mode t)
(setq show-paren-delay 0.0)
;; limit files to 80 columns. Controversial, I know.
(setq-default fill-column 80)
;; handle very long lines without hurting emacs
(global-so-long-mode)
editorconfig looks for an .editorconfig
file, and sets indents and other coding conventions as instructed.
(use-package editorconfig
:defer 1
:config
(editorconfig-mode 1))
whitespace-cleanup-mode cleans up messy whitespace in a document only if it was clean when opening.
(defun me/hide-trailing-whitespace ()
(setq show-trailing-whitespace nil))
(use-package whitespace-cleanup-mode
:demand t
:hook
(special-mode . me/hide-trailing-whitespace)
(comint-mode . me/hide-trailing-whitespace)
(compilation-mode . me/hide-trailing-whitespace)
(term-mode . me/hide-trailing-whitespace)
(vterm-mode . me/hide-trailing-whitespace)
(shell-mode . me/hide-trailing-whitespace)
(minibuffer-setup . me/hide-trailing-whitespace)
:custom
(show-trailing-whitespace t)
:config
(global-whitespace-cleanup-mode 1))
rainbow-delimiters color brackets in various colors to easier identify them.
(use-package rainbow-delimiters
:defer 1
:hook (prog-mode . rainbow-delimiters-mode)
:config
(set-face-attribute 'rainbow-delimiters-unmatched-face nil
:foreground "red"
:inherit 'error
:box t))
=evil-lion= is a package to make alignment of text easier.
(use-package evil-lion
:commands evil-lion-left evil-lion-right
:after evil
:general
(:states 'normal
"ga" 'evil-lion-left
"gA" 'evil-lion-right)
(:states 'visual
"ga" 'evil-lion-left
"gA" 'evil-lion-right))
parinfer is a magical way to edit lispy languages, that allows you to just focus on indentation and code layout. The brackets get inserted and adjusted automagically.
We use parinfer-rust-mode most of the time, and fall back to parinfer-mode, an pure elisp variant on Windows.
(use-package parinfer-rust-mode
:defer 1
:if *is-unix*
:hook
emacs-lisp-mode
lisp-mode
clojure-mode
:custom
(parinfer-rust-auto-download t))
(use-package parinfer
:defer 1
:if *is-windows*
:hook
(emacs-lisp-mode . parinfer-mode)
(lisp-mode . parinfer-mode)
(clojure-mode . parinfer-mode)
:init
(setq parinfer-extensions '(defaults pretty-parens evil)))
orgmode is a tool to organize information in plaintext documents. This configuration is using orgmode to interleave text and code.
(use-package org
:straight (:type built-in)
:general
(leader-def
"o" '(:ignore t :wk "org")
"oa" 'org-agenda)
(localleader-def
:keymaps 'org-mode-map
:major-modes t
"," '(org-insert-structure-template :wk "insert block")
"e" '(:ignore t :wk "execute")
"ee" '(org-babel-execute-maybe :wk "execute (dwim)")
"es" '(org-babel-execute-src-block :wk "execute block")
"eb" '(org-babel-execute-buffer :wk "execute buffer")
"et" '(org-babel-execute-subtree :wk "execute subtree")
"'" '(org-edit-special :wk "edit block")
"tv" 'org-change-tag-in-region
"xt" 'org-table-iterate-buffer-tables
"b" '(:ignore t :wk "babel")
"bt" 'org-babel-tangle)
(:keymaps 'org-src-mode
:definer 'minor-mode
:states 'normal
"RET" '(org-edit-src-exit :wk "save")
"q" '(org-edit-src-abort :wk "abort"))
:custom
(org-directory "~/Sync/org")
;; use syntax-highlighting for src blocks
(org-src-fontify-natively t)
;; open another window when editing src blocks
(org-src-window-setup 'other-window)
;; strip blank lines when closing src block editor
(org-src-strip-leading-and-trailing-blank-lines t)
;; preserve indentation in src blocks, don't re-indent
(org-src-preserve-indentation t)
;; respect the src block syntax for tabs
(org-src-tab-acts-natively t)
;; wrap lines on startup
(org-startup-truncated nil)
;; if editing in an invisible region, complain.
(org-catch-invisible-edits 'show-and-error)
;; don't ask when evaluating every src block
(org-confirm-babel-evaluate nil)
;; don't hide emphasis markers, because there are soo many
(org-hide-emphasis-markers nil)
;; try to draw utf8 characters, don't just show their code
(org-pretty-entities t)
;; add a background to begin_quote and begin_verse blocks.
(org-fontify-quote-and-verse-blocks t)
;; use a pretty character to show a collapsed section
(org-ellipsis " ▿")
;; don't collapse blank lines when collapsing a tree
;; as that messes with the ellipsis.
(org-cycle-separator-lines -1)
;; don't align tags
(org-tag-column 0)
;; allow #+BIND to be used for org-export
(org-export-allow-bind-keywords t)
(org-html-checkbox-type 'html)
:hook (org-mode . org-indent-mode)
:config
(add-to-list 'org-structure-template-alist '("se" . "src elisp"))
(add-to-list 'org-structure-template-alist '("ss" . "src sh"))
(add-to-list 'org-structure-template-alist '("sp" . "src python"))
(org-babel-do-load-languages 'org-babel-load-languages
'((emacs-lisp . t)
(python . t)
(shell . t))))
(use-package ox-gfm
:after org)
org-superstar-mode makes prettier the headings in orgmode, with unicode bulletpoints.
(defun me/lightweight-superstar-mode ()
"Start Org Superstar differently depending on the number of lists items."
(let ((list-items
(count-matches "^[ \t]*?\\([+-*]\\|[ \t]\\*\\)"
(point-min) (point-max))))
(unless (< list-items 100))
(org-superstar-toggle-lightweight-lists))
(org-superstar-mode 1))
(use-package org-superstar
:after all-the-icons org
:commands
org-superstar-mode
org-superstar-toggle-lightweight-lists
:hook (org-mode . me/lightweight-superstar-mode)
:custom
;; draw pretty unicode heading bullets
(org-superstar-headline-bullets-list '("⌾" "◈" "⚬" "▷"))
;; don't hide leading stars
(org-hide-leading-stars nil)
;; replace them with spaces!
(org-superstar-leading-bullet ?\s)
;; draw pretty todo items
(org-superstar-special-todo-items t)
;; draw pretty unicode list bullets
(org-superstar-prettify-item-bullets t))
Track time spent on tasks in org-mode. Inspired by raxod502/radian emacs config, we lazy-load org-clock, as org-clock-load
and org-clock-save
tend to cause a second or two delay.
(use-package org-clock
:straight nil
:after org
:custom
;; resume clock when clocking into a task with an open clock
(org-clock-in-resume t)
;; don't keep empty clock-times, usually made in error
(org-clock-out-remove-zero-time-clocks t)
;; include the task in the clock report
(org-clock-report-include-clocking-task t)
;; only auto-resolve clocks when theres no ongoing clock
(org-clock-auto-clock-resolution 'when-no-clock-is-running)
;; save the running clock when emacs closes
(org-clock-persist t)
:general
(localleader-def
:keymap org-mode-map
"c" '(:ignore t :wk "clock")
"ci" 'org-clock-in
"co" 'org-clock-out
"cf" 'org-clock-goto
"cq" 'org-clock-cancel
"cc" 'org-clock-in-last)
:commands
org-clock-in
org-clock-out
org-clock-goto
org-clock-cancel
org-clock-in-last
org-clock-load
org-clock-save
:hook
;; lazy-load org-clock-persistence-insinuate,
;; as it slows down init quite a bit.
;; source:
(org-mode . org-clock-load)
(kill-emacs-hook . (lambda ()
(when (featurep 'org-clock)
(org-clock-save))))
:config
(org-clock-load))
org-projectile creates a per-project org file, and adds some convenience functions to make it easy to jump to.
(use-package org-projectile
:after projectile org
:defer 1
:general
(leader-def
"po" 'org-projectile-project-todo-completing-read
"op" 'org-projectile-project-todo-completing-read)
:custom
(org-projectile-per-project-filepath "todo.org")
;; https://github.com/IvanMalison/org-projectile#project-headings-are-links
(org-confirm-elisp-link-function nil)
:config
(org-projectile-per-project)
(projectile-add-known-project org-directory)
;; avoid adding non-existing files.
(setq org-agenda-files
(append org-agenda-files
(delq nil (mapcar (lambda (file) (if (file-exists-p file) file))
(org-projectile-todo-files)))))
(push (org-projectile-project-todo-entry) org-capture-templates))
(defun me/disable-flycheck-checkers-for-elisp ()
(setq-local flycheck-disabled-checkers '(emacs-lisp-checkdoc)))
(use-package elisp-mode
:straight (:type built-in)
:hook
(org-src-mode . me/disable-flycheck-checkers-for-elisp)
:general
(localleader-def
:keymaps 'emacs-lisp-mode-map
:major-modes t
"e" '(:ignore t :wk "eval")
"ee" 'eval-defun
"es" 'eval-last-sexp
"eb" 'eval-buffer
"er" 'eval-region))
(use-package git-modes)
(use-package nix-mode)
(use-package nixpkgs-fmt
:hook (nix-mode . nixpkgs-fmt-on-save-mode))
(use-package pretty-sha-path
:hook
(shell-mode . pretty-sha-path-mode)
(dired-mode . pretty-sha-path-mode))
(use-package direnv
:config
(add-hook 'prog-mode-hook #'direnv--maybe-update-environment)
(direnv-mode 1))
(use-package markdown-mode
:commands gfm-mode markdown-mode
:mode
("README\\.md\\'" . gfm-mode)
("\\.md\\'" . markdown-mode)
("\\.markdown\\'" . markdown-mode)
:custom
(markdown-command '("pandoc" "--from=markdown" "--to=html5")))
(use-package clojure-mode)
(use-package cider
:hook (clojure-mode . cider-mode))
(use-package clj-refactor
:after cider
:hook (clojure-mode . clj-refactor-mode))
(use-package pug-mode)
(use-package php-mode)
(use-package ac-php
:after php-mode
:hook
(js2-mode . #'ac-php-mode)
:config
(add-to-list 'company-backends #'company-ac-php-backend))
(use-package web-mode)
(use-package emmet-mode
:commands emmet-mode
:hook
(web-mode . emmet-mode))
(use-package js2-mode
:interpreter (("node" . js2-mode))
:config
(add-hook 'js-mode-hook #'js2-minor-mode)
(add-to-list 'auto-mode-alist '("\\.js$" . js2-mode))
(add-to-list 'auto-mode-alist '("\\.json$" . js2-mode)))
(use-package add-node-modules-path)
(use-package terraform-mode)
(use-package hcl-mode)
(defun me/elixir-mode-save-hook ()
(add-hook 'before-save-hook 'elixir-format nil t))
(use-package elixir-mode
:commands elixir-mode
:mode
("\\.exs?" . elixir-mode)
("\\.elixir" . elixir-mode)
:hook
(elixir-mode . me/elixir-mode-save-hook))
(use-package async
:demand t)
(defvar *config-file* (expand-file-name "config.org" user-emacs-directory)
"The configuration file.")
(defvar *config-last-change* (nth 5 (file-attributes *config-file*))
"Last modification time of the configuration file.")
(defvar *show-async-tangle-results* nil
"Keeps *emacs* async buffers around for later inspection.")
(defun me/config-updated ()
"Checks if the configuration file has been updated since the last time."
(time-less-p *config-last-change*
(nth 5 (file-attributes *config-file*))))
(defun me/async-babel-tangle (org-file)
"Tangles the org file asynchronously."
(let ((init-tangle-start-time (current-time))
(file (buffer-file-name))
(async-quiet-switch "-q"))
(async-start
`(lambda ()
(require 'ob-tangle)
(org-babel-tangle-file ,org-file))
(unless *show-async-tangle-results*
`(lambda (result)
(if result
(message "SUCCESS: %s successfully tangled (%.2fs)."
,org-file
(float-time
(time-subtract (current-time)
',init-tangle-start-time)))
(message "ERROR: %s as tangle failed." ,org-file)))))))
(defun me/config-tangle ()
"Tangles the org file asynchronously."
(when (me/config-updated)
(setq *config-last-change*
(nth 5 (file-attributes *config-file*)))
(me/async-babel-tangle *config-file*)))
(defun me/config-tangle-hook ()
(when (and (not (null buffer-file-truename))
(equal (expand-file-name buffer-file-truename)
*config-file*))
(add-hook 'after-save-hook
#'me/config-tangle
nil 'make-it-local)))
(add-hook 'org-mode-hook #'me/config-tangle-hook)
;; Local Variables:
;; flycheck-disabled-checkers: (emacs-lisp-checkdoc)
;; byte-compile-warnings: (not free-vars)
;; End: