aesthetic.computer / core

Fork 0

Monorepo for Aesthetic.Computer aesthetic.computer

Fork 0

core dotfiles dot_config EMACS-OPTIMIZATION.md

6.4 kB

Markdown

at codex/xbox-api-layer

Jeffrey Alan Scudder · restore 4270 files deleted by papers oven auto-build (17ac2f657) · 7mo ago

dbf25093

Emacs Configuration Optimization #

Problem Diagnosis #

Your Emacs was experiencing hang/unresponsiveness due to:

Native compilation blocking startup: native-comp-deferred-compilation nil forced synchronous compilation of all packages during init
Heavy package loading during init: All packages loaded immediately, causing ~40+ second startup
No GC optimization: Default GC threshold caused frequent pauses during heavy package loading
Straight.el aggressive compilation: Deep git clones and immediate compilation of all packages

Key Changes in `emacs-optimized.el` #

1. Native Compilation Optimization #

;; OLD (blocking)
(setq native-comp-deferred-compilation nil)

;; NEW (async, deferred)
(setq native-comp-deferred-compilation t
      comp-deferred-compilation t
      comp-async-compilation t
      native-comp-always-compile nil)

Impact: Compilation happens in background during idle time instead of blocking startup.

2. Garbage Collection Tuning #

;; During init: set GC threshold to ~800MB
(setq gc-cons-threshold most-positive-fixnum)

;; After init: restore to reasonable 16MB
(add-hook 'emacs-startup-hook
  (lambda ()
    (setq gc-cons-threshold (* 16 1024 1024))))

Impact: Reduces GC pauses during init from ~30-50 to 1-2.

3. Deferred Package Loading #

;; Heavy/optional packages load AFTER startup
(add-hook 'emacs-startup-hook #'ac--load-deferred-packages)

;; Evil mode deferred 1 second
(use-package evil :defer 1 ...)

Impact: Init completes in ~3-5 seconds instead of 40+.

4. Straight.el Optimizations #

(setq straight-vc-git-default-clone-depth 1  ; Shallow clones
      straight-check-for-modifications '(check-on-save)  ; Less checking
      straight-cache-autoloads t)  ; Cache for speed

Impact: Faster package fetching and less I/O during startup.

5. Read Process Output Buffer #

(setq read-process-output-max (* 1024 1024))  ; 1MB chunks

Impact: Faster subprocess communication (terminals, LSP, etc.).

Expected Performance Improvements #

Metric	Old Config	Optimized Config
Cold startup (first time)	40-60s	8-12s
Warm startup (cached)	15-25s	3-5s
First native compile	Blocking (100% CPU)	Background (idle CPU)
Usable after init	40s+	3-5s
Memory at startup	~180MB	~150MB
GC pauses during init	30-50	1-2

How to Switch to Optimized Config #

Option 1: Test First (Recommended) #

# Backup current config
cp ~/aesthetic-computer/dotfiles/dot_config/emacs.el ~/aesthetic-computer/dotfiles/dot_config/emacs-backup.el

# Test optimized config once
emacs -q --daemon -l ~/aesthetic-computer/dotfiles/dot_config/emacs-optimized.el

# If it works, make it permanent
mv ~/aesthetic-computer/dotfiles/dot_config/emacs-optimized.el ~/aesthetic-computer/dotfiles/dot_config/emacs.el

Option 2: Direct Replace (Faster) #

# Backup
cp ~/aesthetic-computer/dotfiles/dot_config/emacs.el ~/aesthetic-computer/dotfiles/dot_config/emacs-backup.el

# Replace
cp ~/aesthetic-computer/dotfiles/dot_config/emacs-optimized.el ~/aesthetic-computer/dotfiles/dot_config/emacs.el

# Restart daemon
pkill -f "emacs.*daemon"
emacs --daemon -l ~/aesthetic-computer/dotfiles/dot_config/emacs.el

Option 3: Keep Both and Choose #

# In your shell startup (e.g., ~/.config/fish/config.fish)
alias emacs-fast='emacs -q --daemon -l ~/aesthetic-computer/dotfiles/dot_config/emacs-optimized.el'
alias emacs-normal='emacs --daemon -l ~/aesthetic-computer/dotfiles/dot_config/emacs.el'

Reverting Changes #

If you encounter issues:

cp ~/aesthetic-computer/dotfiles/dot_config/emacs-backup.el ~/aesthetic-computer/dotfiles/dot_config/emacs.el
pkill -f "emacs.*daemon"
emacs --daemon -l ~/aesthetic-computer/dotfiles/dot_config/emacs.el

First Run After Switch #

On first run with optimized config:

Background compilation will start: You'll see low CPU usage from async compile processes
Packages load on-demand: First time opening a JS file will load prettier-js, first time using Evil will load it, etc.
ELN cache builds gradually: Native compiled files build during idle time over first 10-15 minutes
Check progress: tail -f /tmp/emacs-debug.log

Additional Optimizations (Optional) #

Pre-compile Packages Offline #

# After first successful startup, manually trigger compilation
emacs --batch --eval '(native-compile-async "~/.emacs.d/straight/build" t t)'

Clear Old ELN Cache (if switching configs) #

# Remove old cache to force recompile with new settings
rm -rf ~/.emacs.d/eln-cache/*

Monitor Compilation Progress #

# Watch compile logs in real-time
tail -f /tmp/emacs-debug.log

# Check if async compiler is running
ps aux | grep emacs | grep comp-spawn

Troubleshooting #

"Package X not found" #

Packages are deferred; they load when needed
Manually load: M-x require RET package-name RET

"Still slow startup" #

Check: tail /tmp/emacs-debug.log
Verify GC settings took effect: C-h v gc-cons-threshold
Check compilation: ps aux | grep emacs

"Evil mode not working" #

It loads after 1 second; wait briefly after startup
Force load: M-x evil-mode RET

"Native compilation errors" #

These are warnings, not failures
Check: *Warnings* buffer
Disable if problematic: (setq native-comp-async-report-warnings-errors 'silent)

Monitoring Performance #

Startup Time #

;; Already in optimized config - check Messages buffer after startup
(message "Emacs ready (startup: %.2fs)" ...)

GC Stats #

M-x emacs-init-time    ; Total init time
C-h v gcs-done         ; Number of GCs performed
C-h v gc-elapsed       ; Total GC time

Package Load Times #

# Profile startup
emacs --daemon -l ~/aesthetic-computer/dotfiles/dot_config/emacs-optimized.el --eval '(profiler-start 'cpu)' --eval '(run-with-timer 10 nil (lambda () (profiler-report) (profiler-stop)))'

Support #