An opinionated Emacs configuration.
Highlights · Preview · Getting started · Key bindings · Layout
- 🧱 Foundation: use-package, helm (& various addons), projectile, flycheck and smartparens.
- 🎨 Looks: dashboard, centaur-tabs, doom-modeline, nerd-icons, pulsar (cursor highlight) and the current Omarchy theme, which is followed live when you switch themes.
- 🛠️ Coding: magit (with forge), and lsp-mode with lsp-ui as the unified backend for completions, diagnostics, code actions and navigation, with company as the completion frontend. apheleia formats Python, JavaScript and HTML on save, and claude-code-ide brings Claude Code into Emacs (
C-c c). - 📝 Notes: org-mode with org-modern and org-roam.
- ⌨️ Editing: which-key shows the available keys after a prefix, expand-region, iedit, move-text and mwim speed up everyday editing, and vterm gives you a real terminal inside Emacs.
- 💻 Languages, configured one file each:
- Emacs v30 or higher (the
:vckeyword ofuse-packageis used) - git and
curl - Font Liberation Mono
- A Nerd Font for the icons: install one with your package manager, or run
M-x nerd-icons-install-fontsin Emacs - Ag - The Silver Searcher
- Formatters for format-on-save (optional, per language):
- Language servers for your active language layers:
- gopls — Go
- rust-analyzer — Rust
- pyright — Python (
pip install pyright) - elixir-ls — Elixir (only if you enable the layer)
- terraform-ls — Terraform (optional)
One command clones the configuration to ~/.emacs.d, takes your name and email for user.el from git config, and installs all Emacs packages:
$ curl -fsSL https://raw.githubusercontent.com/otype/emacs.d/main/install.sh | bashPrefer to read the script first?
$ curl -fsSLO https://raw.githubusercontent.com/otype/emacs.d/main/install.sh
$ less install.sh
$ bash install.shThe installer is safe to run again: it fast-forwards an existing clone, leaves a checkout with local changes alone, and moves any other existing ~/.emacs.d to ~/.emacs.d.bak-<timestamp> before cloning. Options (append them to the pipe with bash -s -- <options>):
| Option | Effect |
|---|---|
--check |
Report what would change and change nothing (exit 1 if anything would) |
--no-packages |
Skip the headless package installation; packages then install on the first start of Emacs |
--name NAME, --email EMAIL |
Set user-full-name and user-mail-address instead of using git config |
It only warns about missing extras (Liberation Mono, a Nerd Font, ag, language servers, black, prettier) and never installs system packages.
After installing, enable more languages by uncommenting the (require 'lang-…) lines in init.el (check each file in /elisp/ for its dependencies), then start emacs.
🔧 Manual installation
$ git clone https://github.com/otype/emacs.d.git ~/.emacs.d
$ $EDITOR ~/.emacs.d/elisp/user.el # your name and email
$ $EDITOR ~/.emacs.d/init.el # enable language layers
$ emacs # installs all packages on first startRun the installer again, or git pull --ff-only in ~/.emacs.d. Reload a running Emacs with C-c <f12>; restart it after package changes.
Everything this configuration binds is listed in docs/keybindings.md. The ones you will use most:
| Binding | What it does |
|---|---|
C-c h … |
🧭 Helm commands |
C-c p … |
📁 Projectile |
C-c m … |
🌿 Magit |
C-c l … |
🧠 LSP actions |
C-c o …, C-c r … |
📝 Org and 🕸️ Org-roam |
C-c c |
🤖 Claude Code menu |
C-c d |
📄 Duplicate line or region |
C-c <f12> |
🔄 Reload this configuration |
| Path | Purpose |
|---|---|
init.el |
Entry point: loads the layers below; language layers are switched on and off here |
elisp/base*.el |
Core settings, theme, packages, custom functions, global key bindings |
elisp/lang-*.el |
One self-contained layer per language |
elisp/user.el |
Your name and email |
themes/omarchy-theme.el |
Omarchy's Emacs theme file. Not in git (it is git-ignored): the Omarchy Emacs integration puts it next to this configuration and base-theme.el loads it |
docs/ |
Documentation, e.g. the key bindings reference |
images/ |
The screenshots shown in the preview |
install.sh |
The installer |
CLAUDE.md |
Notes for Claude Code: architecture, how to reload and validate changes |
.githooks/ |
A pre-commit hygiene check. Enable it per clone with git config core.hooksPath .githooks |


