
It's a tale as old as time: a stubborn, shell-dwelling, and melodramatic vimmer -- tormented by Vimscript and his boundless productivity -- makes a formal request to the netherworld for a transfer. They agree. The terms? He must lure more unsuspecting souls into a life of eternal bikeshedding. Now he runs the place.
Doom Emacs is an Emacs Lisp development tool and configuration framework for GNU Emacs, tailored for Emacs enthusiasts that want a faster, more reliable, and reproducible foundation for their next config or elisp project, or for beginners who want a softer introduction to our favorite operating system.
git clone --depth 1 https://github.com/doomemacs/doomemacs ~/.config/emacs
~/.config/emacs/bin/doom install
This is the quickest way to get a Doom environment up and running. Visit our getting started guide for more in-depth instructions.
- Emacs 27.1–30.1 (30.1 is recommended)
- Git 2.23+
- Ripgrep 11.0+
Warning
Doom core supports 27.1, but Doom's modules requires 28.1 at minimum. Some
modules (particularly tree-sitter) require 29.1 or newer. Other module
requirements may apply, so don't forget to run $ doom doctor
after
installing Doom!
- Homepage (WIP)
- Discussions board
- Discord server
- Official documentation (WIP)
- Community wiki (WIP)
- Announcements
- Release notes (WIP)
- Project roadmap (WIP)
- Do-Not-PR list
- Packages under review
- https://youtube.com/@doomemacs
- https://fosstodon.org/@doomemacs
- https://twitter.com/doomemacs (mirrored from fosstodon)
- https://bsky.app/profile/doomemacs.bsky.social (mirrored from fosstodon)
Doom and its community are labors of love and the incurable madness of its maintainer and volunteers. Doom wouldn't be where it is today without your help. Help us keep the lights on by:
- Contributing bug reports, code, or documentation
- Adding to, polishing, or translating our community wiki.
- Joining the Doom Emacs community as:
- Sponsoring the author.