init.el

package.el is deliberately not loaded on a normal startup: requiring it costs ~90ms, almost all of it the url / browse-url / auth-source subtree it pulls in — and none of that is needed unless a package is actually being installed. The quickstart bundle performs the activation on its own.

package-archives declares the three repositories packages are fetched from: GNU ELPA (the official, copyright-assigned archive), NonGNU ELPA (free packages without copyright assignment), and MELPA (the large community archive). Wrapped in with-eval-after-load, they're in place whenever package.el does load — the first-run bootstrap, M-x package-install, or the :ensure fallback below installing something new.

package-quickstart makes package.el maintain a single quickstart file containing package autoloads, load paths, and the activated package list. Loading that compiled bundle is much faster than scanning every installed package directory on every startup.

load is given the suffix-less name so it appends load-suffixes itself — trying package-quickstart.elc then package-quickstart.el — which keeps the compiled-first preference and lets native-comp swap in a .eln when one exists. With NOERROR, load returns nil if neither file exists, and only then — a first run or after deleting the quickstart file — does it fall back to a full package-initialize followed by package-quickstart-refresh.

use-package ships with Emacs 29+, so it's require-able directly — no install step, no package.el needed.

use-package-always-ensure t makes every use-package form auto-install its package from ELPA if missing.

Turns off Emacs's automatic file~ backup copies, which otherwise litter every directory you edit in. Pure preference.

use-short-answers t lets you answer the long yes-or-no-p prompts ("Quit? (yes or no)") with a single y/n instead of typing the whole word plus RET.

The custom-file lines keep Emacs's Custom system out of init.el. Left unset, custom-file defaults to user-init-file and Custom rewrites its machine-generated blocks into init.el (which is how stale entries crept in before). Pointing it at a separate, gitignored custom.el — then loading it with NOERROR so a missing file is harmless — keeps init.el hand-edited only.

Enables Emacs's own mouse reporting in the terminal, so the wheel arrives as real mouse-4/mouse-5 events that route to mwheel-scroll.

Tunes scrolling so the view moves, not point:

• mouse-wheel-follow-mouse — scroll the window under the pointer.
• mouse-wheel-progressive-speed nil — constant speed; don't accelerate on fast spins.
• mouse-wheel-scroll-amount — 2 lines per notch; Shift+wheel = 1 line; Ctrl+wheel = text zoom.
• scroll-conservatively 101 — scroll one line at a time for keyboard motion, never recenter with a jump. (scroll-step is intentionally omitted — it's ignored whenever scroll-conservatively is > 100.)
• scroll-margin 0 — let the cursor reach the very top/bottom edge before the view is dragged.
• make-cursor-line-fully-visible nil — don't force a recenter after a wheel scroll.

display-line-numbers-type t selects absolute line numbers (switch to 'relative or 'visual for Vim-style relative numbering).

global-display-line-numbers-mode shows them in the gutter everywhere; global-hl-line-mode highlights the line point is on.

The current-line highlight obscures the bounds of a selection under some themes, so it's suspended while a selection is active — an Evil visual state or a vanilla region.

recentf tracks recently opened files (consumed by neoemacs/consult-recent-file at SPC f r). :ensure nil because it ships with Emacs. :custom raises the remembered count to 100; :init (recentf-mode 1) turns it on.

The :config block fixes a multi-instance race. Each Emacs holds its own in-memory recentf-list and overwrites the shared save file, so a naive save would erase another instance's history. neoemacs--recentf-merge-from-disk re-reads the on-disk list and merges it (append + delete-dups, then seq-take caps it and recentf-cleanup prunes dead entries), and it's installed both as :before advice on every recentf-save-list and in the SPC f r wrapper so reads see what others recorded too.

autorevert reloads a buffer whose backing file changed on disk, as long as the buffer has no unsaved edits. global-auto-revert-non-file-buffers extends this to dired/dirvish (and other non-file buffers), so directory listings refresh too. Reverts are silent (auto-revert-verbose nil). Enabled from emacs-startup-hook — no file buffer can exist before startup finishes, so the load stays off the pre-paint path.

Installs the doom-themes pack, enables bold and italic face variants, and loads doom-one (the dark theme from Doom Emacs). The t second argument to load-theme means "no confirmation, trust this theme."

nerd-icons supplies the glyph fonts that the modeline and dirvish draw file-type icons from.

doom-modeline is the rich status bar matching the theme. :after nerd-icons guarantees the icon library loads first; :init activates the mode.

Evil brings modal Vim editing. Settings are in :init because they must be set before the package loads:

• evil-want-integration t — load Evil's integration layer.
• evil-want-keybinding nil — required so that evil-collection (next) provides the keybindings instead of Evil's own defaults; the two would clash otherwise.
• evil-want-C-u-scroll t — restore Vim's C-u half-page scroll (Emacs normally uses C-u as a prefix arg).
• evil-search-module 'evil-search — use Vim-style evil-ex-search for / and ? (incremental, n/N repeat, search highlighting, :s offsets) instead of the default isearch backend.
• evil-symbol-word-search t — */# (and /) match the whole symbol under point, so a name like evil-ex-search is one unit instead of stopping at the first -.
• evil-move-beyond-eol t — let point move one column past the end of the line.
• evil-echo-state nil — don't print -- INSERT -- etc. in the echo area (the modeline already shows the state).

:config turns Evil on, then rebinds normal-state Esc to neoemacs/escape-clear-search: it clears the evil-ex-search highlight (Vim's :nohlsearch) before falling back to evil-force-normal-state.

evil-collection supplies consistent Evil bindings for hundreds of built-in and third-party modes (dired, help, magit, …). It loads from emacs-startup-hook: evil-collection-init immediately requires the per-mode binding file for every feature that's already loaded (simple, help, info, …) — a long tail of small loads that would otherwise sit on the pre-paint path. The hook still runs before any user input is processed, so the bindings are in place for the first keystroke.

delq 'magit … removes magit from the list of modes it will touch before evil-collection-init applies the rest.

In GUI Emacs, cursor-type alone changes the cursor shape — but in emacs -nw it does nothing. This package emits DECSCUSR escape sequences on each Evil state change so the host terminal's cursor reflects the mode:

• normal / visual / motion → block
• insert → vertical bar
• replace / operator → underline (hbar)
• emacs state → hollow box

etcc-use-blink nil forces the steady DECSCUSR codes (ESC [ 2/4/6 q) in every state — no blinking.

evil-surround ports Vim surround operations: ys adds, cs changes, and ds deletes surrounding pairs; visual-state S surrounds the selected region.

evil-commentary adds comment operators: gcc toggles the current line, gc{motion} comments a motion, and gc works on a visual selection using the major mode's comment syntax.

evil-goggles briefly highlights the text affected by edits such as yank, delete, change, paste, and indent. Diff faces make additions/deletions easy to spot, while pulse animation is disabled to keep terminal redraws cheap. Loaded from emacs-startup-hook: the flash only matters once you edit, and evil-goggles-use-diff-faces drags in all of diff-mode for its faces.

evil-anzu shows the match count of the active evil-ex-search (/ and ?) in the mode line as current/total (e.g. 1/3). It pulls in anzu, whose global-anzu-mode installs the indicator, and wires anzu's counter into Evil's search so the count updates as you type and on n/N. The indicator clears when the search highlight is cleared (the normal-state Esc binding above).

avy jumps to any visible position: s in normal state runs evil-avy-goto-char-timer — type the target characters, pause, then hit the overlay label to jump. avy-background dims everything but the candidates while the hints are up so the labels pop. The evil motion wrapper is defined eagerly by evil-integration.el when Evil loads and avy autoloads on first invocation, so this form only installs the package. Bound in evil-normal-state-map rather than the override map so mode-local s bindings (dired's sort, magit) still win; it shadows evil-substitute (cl is equivalent).

A vertical split that also follows focus into the new pane. Evil's evil-window-vsplit by itself leaves point in the original window; the evil-window-right 1 moves into the freshly created one. interactive makes it a callable command. Bound to s-n below.

Opens a terminal in a fresh split (bound to s-t and SPC t):

• vsplit-window-follow makes the split and moves into it.
• evil-buffer-new shows an empty *new* buffer there.
• (ghostel '(4)) launches the terminal. The non-numeric prefix arg '(4) forces a new terminal rather than reusing an existing one.

By default the terminal is rooted at the originating buffer's project root, captured into root before the split (the placeholder buffer can carry a different default-directory), then bound around the ghostel call via let*. Outside a project it falls back to the current directory. A prefix arg — or neoemacs/vsplit-ghostel-here (SPC u t) — skips the root and starts in the current default-directory. projectile is deferred, so it's required on demand.

A no-prompt help command (bound to K in elisp buffers, Vim-style). symbol-at-point grabs the symbol under the cursor; if there is one, helpful-symbol opens the richer Helpful buffer without the usual minibuffer prompt.

The when-let scans live windows for one whose buffer is derived from helpful-mode, then selects it. Focus lands in the help window, so you can immediately scroll it and press q to dismiss. If there's no symbol, user-error reports it cleanly (no stack trace).

Opens a normal find-file prompt rooted at this config directory. It is bound to SPC f p, so editing the private config never depends on the current project or buffer.

The shared launcher for the macOS app helpers below. Under zellij Emacs is a child of zellij's detached background server, whose Mach bootstrap namespace is cut off from the GUI login session — so a plain open silently fails (the classic tmux pbcopy/open bug). When $ZELLIJ is set it prepends reattach-to-user-namespace to re-enter the user namespace and restore GUI access; otherwise the args run directly.

SPC o f opens the current file in whatever app macOS has registered for that file type. In dired/dirvish it's the file under point; elsewhere the visited file. It hands the file to open with no -a, so LaunchServices routes it exactly like a Finder double-click. (This replaced an earlier Quick Look command: qlmanage draws its panel from the calling process and just blocks under zellij, whereas open hands the request to LaunchServices, which launches the app inside the GUI session.)

SPC o d opens the relevant directory in Finder. In dired/dirvish it follows the listed directory; elsewhere it uses default-directory.

SPC o o opens the current file in Obsidian. It detects the nearest parent directory containing .obsidian, uses that directory name as the vault name, builds an obsidian://open URL for the file relative to the vault root, and hands it to macOS open.

general is the keybinding DSL. general-create-definer builds a reusable leader command, neoemacs/leader:

• :states — active in normal, visual, and motion Evil states.
• :keymaps 'override — bind in an override map so nothing shadows the leader.
• :prefix "SPC" — Space is the leader.
• :global-prefix "M-SPC" — M-Space works as a fallback in insert/emacs states where Space inserts text.

The leader menu. Each entry maps a key sequence to a command plus a :which-key label shown in the popup. Top-level shortcuts: SPC SPC → find file in project, SPC , → switch buffer, SPC : → eval expression, SPC x → M-x, SPC / → search the project with ripgrep, SPC s → save buffer, SPC w → delete window, SPC n → vsplit & follow, SPC t → ghostel terminal at the project root.

Mnemonic groups, where :ignore t defines a prefix that only carries a which-key label (no command of its own):

• f files — ff find, fp config file, fr recent, fd switch directory (consult-dir).
• b buffers — switch / kill / ibuffer / next / prev, plus bu → vundo (the visual undo tree).
• p project — pp switch project, pf find file, pb project buffer, ps ripgrep search.
• g git — status, blame, file log, and diff-hl hunk navigation/stage/revert.
• o open — oo opens the current file in Obsidian, of opens it in its default macOS app, od reveals the current directory in Finder.
• c code — lsp-mode code actions / rename / format and flymake diagnostics, consult-lsp symbol/diagnostic pickers (cs file symbols, cS workspace symbols, cD workspace diagnostics), plus cc → consult-claude-sessions (the live Claude Code session switcher).
• u ghostel — ut opens a ghostel terminal in the current directory (the t variant uses the project root).
• h → the whole help-command map.

With the dashboard gone, startup time is exposed through the normal help map: SPC h t and C-h t both call emacs-init-time.

State- and keymap-scoped bindings (layer 2 of the keybinding architecture):

• - in normal state → dired-jump (vim-vinegar-style "jump to the directory of this file"); ff in normal state → neoemacs/consult-recent-file; fd in normal state → neoemacs/consult-dir; fc in normal state → consult-claude-sessions.
• s-h/j/k/l — move between windows (the Super/Cmd key + hjkl).
• s-n — vertical split and follow; s-s — save buffer; s-w — delete window.
• S-s-[ — rotate windows; S-s-] — maximize (delete others).
• K — only in emacs-lisp-mode / lisp-interaction-mode, describe the symbol under point.

Two editing-model tweaks, also via general:

• , is a general-simulate-key alias that replays the real C-c prefix through the live keymaps, so , x runs whatever C-c x is bound to in the current buffer (including major-mode maps: , C-c → C-c C-c). Restricted to normal/visual/motion so a literal comma still types in insert — it shadows evil's repeat-find-backwards in those states.
• j/k move by visual line, so navigation follows wrapped text instead of jumping a whole logical line; gj/gk keep the logical-line motions one keystroke away.

expand-region grows/shrinks the selection by semantic units (word → string → sexp → defun …). In visual state, v expands the region and V contracts it — keep tapping v to widen the selection one syntactic level at a time.

vundo visualizes the built-in undo history as a tree. It does not replace Emacs undo and does not create persistent undo-history files. It is reached via SPC b u, and the Unicode glyphs make the tree clearer in the terminal.

which-key shows a popup of the available follow-up keys after you start a prefix (this is what renders the leader menu labels). :ensure nil because it's built in to modern Emacs. Loaded from emacs-startup-hook — the popup only appears about a second after a held prefix key, so it can never be needed before startup finishes.

The settings mirror Doom's which-key tuning for readability: alphabetical key ordering (lowercase first), one column of padding, no cap on the number of columns, at least six display lines, and the popup pinned to the bottom side window (which-key-setup-side-window-bottom) with extra line-spacing in its buffer.

Vertico is the UI layer: it turns minibuffer completion into a clean vertical list of candidates instead of the default horizontal one.

vertico-directory ships with Vertico and makes file-name completion behave like a path editor. RET enters directories, DEL deletes one character, and M-DEL deletes a whole path component. The tidy hook removes shadowed path prefixes like stale ~/ text when an absolute path is typed.

Orderless is the matching layer: type space-separated fragments in any order (e.g. buf swi matches "switch-buffer"). completion-styles tries orderless first, falling back to basic.

The file category override uses partial-completion so path completion keeps the familiar /u/s/b → /usr/share/bin shorthand.

Marginalia is the annotation layer: it adds rich notes in the right margin of each candidate — docstrings for commands, file sizes and permissions, variable values, and so on.

nerd-icons-completion adds colored icons to file, directory, and buffer candidates. A local advice then post-processes file completion affixations and tints directory names with the same face as the folder icon, while regular file names keep their default text face.

Consult is the commands layer — enhanced search/navigation that feeds candidates into Vertico. Bound via plain global chords:

• C-s — consult-line (live in-buffer search).
• C-x b — buffer switcher with previews.
• M-y — browse the kill ring on paste.
• M-g g — go to line; M-g i — jump via imenu.
• ? in consult-narrow-map — list the narrowing keys (consult-narrow-help) while a multi-source prompt is open.

consult-dir switches the directory context from the minibuffer. C-x C-d globally jumps to a directory (recent dirs, projectile roots, bookmarks); the same chord inside an active find-file/consult prompt re-roots it at the chosen directory without restarting, and C-x C-j fuzzy-jumps to any file beneath it. Also on the leader at SPC f d and as fd in normal state.

embark is the context-action layer: s-] opens actions for the current target or minibuffer candidate, and M-. runs the default action. C-h b / SPC h b are upgraded to embark-bindings, a searchable active-keybinding view.

embark-consult connects Embark exports and previews to Consult candidate buffers, so search results can be exported into editable or actionable buffers.

wgrep makes grep result buffers editable. A typical flow is consult-ripgrep, embark-export, then C-c C-p to enter wgrep mode; edits are saved back to the touched files with C-c C-c. Auto-save is enabled so changed buffers are written when the wgrep edit is committed.

helpful replaces the common help commands under both C-h and SPC h. It shows source, values, callers, keybindings, and richer symbol context than the built-in help buffers.

ibuffer is the bulk buffer-management view, bound to C-x C-b and SPC b i. Evil collection supplies familiar navigation and marking keys. ibuffer-auto-mode keeps the list live, and ibuffer-expert removes repetitive kill confirmations.

ibuffer-projectile groups buffers by Projectile project. Embark can also export a narrowed consult-buffer candidate set directly into ibuffer for bulk actions.

corfu is the at-point completion popup — vertico handles M-x/find-file prompts, corfu handles completion inside a buffer (e.g. the candidates lsp-mode produces while typing code). It pops up automatically after two characters, and corfu-preselect 'valid preselects the typed prefix only when it is itself a valid match — otherwise the first candidate is selected, so RET completes to a real candidate. While the popup is open, SPC inserts an orderless separator (to keep narrowing), RET completes, and TAB/S-TAB cycle candidates; corfu-preview-current nil stops the candidate showing as inserted-but-uncommitted text, and corfu-quit-at-boundary nil keeps the popup open across completion boundaries like / in paths.

corfu-terminal re-renders corfu's child-frame popup as a buffer overlay so it works under emacs -nw; the display-graphic-p guard makes it a no-op in a GUI frame. cape adds file-path and in-buffer-word (dabbrev) completion-at-point backends as fallbacks; in lsp-mode-managed buffers the LSP capf supplies code completion.

Magit is the Git interface. C-x g opens status. Inside the status buffer, e is rebound to neoemacs/magit-ediff-working-vs-head — a plain two-buffer ediff of the file-at-point's working-tree version against its HEAD version (magit-ediff-compare "HEAD" nil …, where the nil REVB picks the working tree; the index is never involved, unlike the three-way magit-ediff-show-working-tree). With no file at point it falls back to magit's default magit-ediff-dwim.

magit-display-buffer-function = the …same-window-except-diff-v1 variant: magit-status opens in the current window, while diffs and other secondary buffers still pop to another window.

Transient is the popup-menu engine behind magit (and many other packages) — :ensure nil because it ships with Emacs, and :defer t keeps it off the startup path. This makes Esc an alias for C-g (transient-quit-one), so pressing Escape backs out of any open transient one level. Bound in transient-map, so it applies to every transient, not just magit's.

Built-in ediff (:ensure nil), deferred until a diff session starts, and tuned two ways:

• ediff-split-window-function = horizontal split → the two diff buffers sit side by side with a vertical divider, not stacked.
• ediff-window-setup-function = plain → the control panel stays in the same frame instead of spawning a popup frame.

diff-hl shows version-control changes in the terminal margin with text glyphs, because fringe indicators are invisible in emacs -nw. It is enabled on emacs-startup-hook so it is ready after init without costing startup time.

The Magit hooks refresh indicators around stage/commit operations, and the dired hook shows per-file VC status in dirvish/dired buffers. The actual config also strips theme-applied background colors from diff-hl faces so the terminal shows readable +, -, and ! glyphs instead of solid color blocks.

Dirvish upgrades dired with previews and icons. dirvish-override-dired-mode makes it the default for all dired. It's armed from emacs-startup-hook: the autoload pulls in dirvish and dired (~70ms) that isn't needed until the first dired buffer, and the hook runs after the first paint but before any input — with nerd-icons and general (which the :config keybindings need) both guaranteed loaded by then.

• The dired hook disables line numbers in file-manager buffers.
• dirvish-attributes — show icons and subtree-expansion state. VC state is handled by diff-hl-dired-mode instead because it is visible in terminal margins.
• dirvish-hide-details nil — keep the full ls -l detail columns visible.
• dired-listing-switches — -A "almost all" shows dotfiles but hides ./..; -l long format. When GNU ls (Homebrew coreutils gls) is present, --group-directories-first is added to sort directories ahead of files, and insert-directory-program is pointed at gls.
• dirvish-hide-cursor nil — keep a real block cursor visible (dirvish normally hides it and relies on hl-line; here etcc renders a proper terminal block).
• dired-dwim-target t — with two dired/dirvish panes, copy and rename default to the directory in the other pane.

C-c f opens dirvish. In normal state inside dired: h goes up a directory, l enters the file/dir, TAB toggles a subtree inline, and y is a "yank" prefix that copies the entry's name/path to the kill ring (yl true path, yn name, yp path, yr remote path), with yy kept as the classic dired-do-copy.

diredfl colorizes the long-listing columns such as permissions, owner, group, size, and modification time. Since dirvish buffers derive from dired, the hook covers both.

dired-x enables dired-omit-mode, hiding uninteresting files such as lock/autosave entries and common compiled artifacts. The omit message is silenced with dired-omit-verbose nil.

kkp enables the Kitty Keyboard Protocol in terminal Emacs, so chords the terminal would otherwise swallow (e.g. C-S-x, distinguishing C-i from Tab) actually reach Emacs.

Under kkp the terminal delivers a shifted Meta chord as a distinct event rather than folding Shift into the base key, so without help M-}, M-(, M-J, etc. would be unreachable. The key-translation-map entries re-map each M-S-… form to the symbol/upper-case key the commands actually bind.

clipetty sends kills (copies) to the host system clipboard via the OSC 52 escape sequence, so yanking in terminal Emacs works even over SSH and through tmux. Enabled on after-init.

ghostel is a terminal emulator powered by libghostty; its native module is a prebuilt binary that auto-downloads on first use. :commands (ghostel) sets up the autoload, and s-t (and SPC t) run the vsplit-and-launch helper from earlier, rooting the terminal at the buffer's project root (SPC u t uses the current directory instead). Terminal buffers turn line numbers off locally because the gutter is not useful there, and the :init hook tags every spawned terminal for Claude Code session tracking (see the Claude section below).

evil-ghostel keeps the terminal cursor in sync with Emacs point across Evil state changes, so normal-state hjkl navigation works inside the terminal buffer. It hooks onto ghostel-mode. Its :config block (broken out in the rows below) adds Escape routing and C-c/C-x passthrough; the redraw-anchor and wheel-scroll advices that used to live here moved upstream (last row of this section).

Escape DWIM. A single Esc is something a terminal program legitimately wants (vi, less, menus), but Esc is also how you leave Evil's insert state. This disambiguates by timing.

• read-key inside with-timeout waits up to neoemacs/ghostel-escape-timeout (0.25s) for a second key. read-key is used because it decodes KKP/input-decode-map sequences; raw read-event can leak bytes to ghostel as control characters.
• If that second key is itself an Escape (--escape-event-p), the user meant "leave insert" → run Evil's normal insert-state Esc binding and send nothing to the terminal.
• Otherwise it was a lone Esc (or Esc followed by another key): push the stray key back onto unread-command-events so it isn't lost, and forward a real escape to ghostel.

Ctrl passthrough. C-c and C-x are precious Emacs prefixes, but inside a terminal you usually want them to reach the program running there (C-c to interrupt, etc.). ghostel-send-current-control recovers the base letter from last-command-event via event-basic-type and forwards it as a real Ctrl chord with ghostel-send-key; the guard user-errors if it's somehow not a Ctrl+letter.

The evil-define-key* wires up the insert-state map: Esc → the DWIM handler, C-c/C-x → the passthrough.

Roaming & wheel scroll (now upstream). Letting normal-state motion roam over animated output, and keeping a mouse-wheel scroll into scrollback from snapping point back to the live cursor, both used to be local advices here (evil-ghostel-roam around ghostel--anchor-window, and evil-ghostel-wheel-normal before mwheel-scroll). The upgraded evil-ghostel subsumes them: it registers evil-ghostel--anchor-inhibit on ghostel's ghostel-inhibit-anchor-functions hook so the per-redraw anchor stands down in a motion-capable Evil state, and ghostel itself intercepts the wheel and gates point-sync on ghostel--window-anchored-p. So both advices were removed from init.el.

The live session switcher itself lives in the separate, terminal-agnostic consult-claude package (below): it owns the in-memory registry, the status RPC (consult-claude-status), the marginalia annotator, and the consult-claude-sessions picker reached at fc in normal state. Only the ghostel-specific glue stays here.

neoemacs--ghostel-tag-env runs on ghostel-pre-spawn-hook: it stamps each new terminal with a unique id, exports it as $NEOEMACS_GHOSTEL_ID (so the shell and its children — including Claude Code — can echo it back), records the buffer in a hash table, and pre-registers the entry with consult-claude-register so a later status report has something to flip. A buffer-local kill-buffer-hook forgets the id when the terminal dies.

consult-claude is the terminal-agnostic package that owns the registry, the status RPC, the marginalia annotator, and the consult-claude-sessions picker. The ghostel glue above (tag-env + register) is all that init.el needs to feed it.

projectile provides project-aware navigation. :defer t keeps it off the startup path, and :bind-keymap installs an autoloaded C-c p prefix that loads projectile-command-map on demand. projectile-mode turns on once the package is actually loaded.

markdown-mode with file-pattern associations. README.md gets gfm-mode (GitHub-Flavored Markdown); other .md / .markdown files get plain markdown-mode. The \\' anchors match the end of the filename.

Wiki links ([[note]]) are enabled and tuned for Obsidian vaults: markdown-wiki-link-search-subdirectories resolves a bare name to a file anywhere under the tree (Obsidian flattens names), and markdown-link-space-sub-char " " keeps link text matching real filenames with spaces. Follow the link under point with C-c C-o.

Tree-sitter major modes. treesit-language-source-alist is populated eagerly (just an alist) so each grammar's fetch/build recipe is known; neoemacs--ensure-treesit-grammars runs the slow git-clone + C compile lazily from a mode's :config, and only when a grammar is missing — never on the startup path.

• typescript-ts-mode / tsx-ts-mode ship with Emacs (:ensure nil), for .ts / .tsx.
• astro-ts-mode for .astro — needs the css + tsx grammars too, since Astro injects other languages into a single file.
• clojure-ts-mode family for .clj / .cljs / .cljc / .edn.

lsp-mode is fully deferred: lsp-deferred on the language hooks arms LSP without loading lsp-mode at startup — it loads the first time one of those modes turns on, and (unlike plain lsp) waits until the buffer is displayed before starting a server. Leader actions live under SPC c (ca code actions, cr rename, cf format, cd diagnostics); in LSP buffers gd and gr jump to definitions and references; the long tail of LSP commands is on C-c l.

All three servers ship as built-in lsp-mode clients: astro-ls (lsp-astro points tsdk at the project's own node_modules/typescript), typescript-language-server for TS/TSX, and clojure-lsp for the tree-sitter Clojure modes. clojure-lsp bundles clj-kondo, so linting arrives over flymake with no separate linter. Code lenses show a grey "N references | M tests" overlay above each definition — the test/reference split is clojure-lsp's :lens-segregate-test-references?, set in ~/.config/clojure-lsp/config.edn. Completion goes through the plain LSP capf (lsp-completion-provider :none) so corfu consumes it directly, matched with orderless like everything else. lsp-auto-guess-root skips the interactive "import project root?" prompt by taking the workspace root from projectile/project.el. Requires the matching server binaries on PATH.

consult-lsp surfaces LSP data through the consult minibuffer UI, with live preview as you move: SPC c s file symbols, SPC c S workspace-wide symbol search, SPC c D workspace diagnostics (the buffer-local flymake list stays on SPC c d). In lsp buffers xref-find-apropos (C-M-.) is remapped to consult-lsp-symbols.

apheleia reformats on save asynchronously — it diffs the formatter output back in, so point/scroll are preserved and the UI never blocks (preferable to lsp-format-buffer on save in a terminal). Armed via apheleia-global-mode on emacs-startup-hook. Astro maps to prettier; TS/TSX use apheleia's defaults.

Lisp structural editing. Three layers ride on the Lisp-family modes — the tree-sitter Clojure modes and emacs-lisp-mode / lisp-interaction-mode: smartparens in strict mode refuses edits that would unbalance a sexp (smartparens-config loads the default pairs); evil-cleverparens adds paredit-style slurp/barf/wrap through evil motions (M-5 / M-] wrap the next/previous form in square brackets); and rainbow-delimiters depth-colors the parens. evil-cleverparens-use-s-and-S is nil because minor-mode maps beat evil-normal-state-map — cleverparens' s would shadow the avy jump in every Lisp buffer; the paren-safe S (evil-cp-change-whole-line) is re-added on its own.

Clojure REPL. cider is the nREPL runtime half — REPL, inline eval, test runner — complementary to clojure-lsp's static analysis (they run together); :after clojure-ts-mode keeps it deferred, and C-c C-j jacks in a REPL (needs clojure/clj or lein on PATH).

envrc applies each buffer's directory .envrc via direnv (needs the direnv executable on PATH).

An Emacs server lets emacsclient hand work to this running Emacs (git commit messages, anything shelling out to $EDITOR from the ghostel terminal) instead of spawning a nested Emacs. The server name is made unique per process by appending the PID (neoemacs-<pid>), so concurrent instances each get their own socket rather than colliding on the default server name. $EDITOR is then pointed at that socket. It's all deferred to emacs-startup-hook, off the critical path.

A formatting helper. Given an absolute directory, it returns <parent>/<dir> — e.g. ~/.config/neoemacs → config/neoemacs.

• directory-file-name + expand-file-name normalize the path (strip trailing slash, make absolute).
• name is the last component; parent is the one above.
• If there's no parent (root), just return the name.

Picks which directory names the tab, in precedence order:

1. Inside a projectile project → the project root.
2. Else a dired buffer → the listed directory.
3. Else a file-visiting buffer → the file's directory.
4. Otherwise nil → leave the tab name unchanged.

fboundp guards the projectile call in case it isn't loaded yet.

The worker. Gated on the $ZELLIJ env var, so it's a no-op outside zellij. It looks at the selected window's buffer (the hooks may fire with a different current buffer), computes the name, and compares it to the last name stored per frame (each Emacs frame maps to its own zellij pane).

Only when the name actually changed does it update the frame parameter and shell out. The executable-find guard avoids errors if the env var is present but the binary is unavailable, and start-process runs asynchronously with output discarded, so buffer switches never block on the subprocess.

Registers the worker on the full range of context changes:

• window-selection-change-functions — window focus moved.
• window-buffer-change-functions — a window's buffer changed (e.g. switch-to-buffer).
• dired-after-readin-hook / dirvish-setup-hook — directory navigation.

provide 'init registers the feature so require works, and the trailing comment is the conventional Emacs Lisp file footer.

There are no custom-set-variables / custom-set-faces blocks here: custom-file is pointed at a separate custom.el (see the core settings above), so Emacs's Custom system writes its machine-generated blocks there instead of appending them to init.el.