{"id":50725625,"url":"https://github.com/doomemacs/core","last_synced_at":"2026-06-15T21:00:49.084Z","repository":{"id":18561750,"uuid":"21763822","full_name":"doomemacs/core","owner":"doomemacs","description":"An Emacs framework for the stubborn martian hacker","archived":false,"fork":false,"pushed_at":"2026-06-11T08:30:28.000Z","size":35839,"stargazers_count":22245,"open_issues_count":532,"forks_count":3155,"subscribers_count":228,"default_branch":"master","last_synced_at":"2026-06-11T09:14:00.568Z","etag":null,"topics":["doomemacs","emacs","emacs-configuration","emacs-lisp","evil","vim"],"latest_commit_sha":null,"homepage":"","language":"Emacs Lisp","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/doomemacs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"docs/contributing.org","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":["hlissner"]}},"created_at":"2014-07-12T09:29:52.000Z","updated_at":"2026-06-11T08:30:38.000Z","dependencies_parsed_at":"2023-02-13T01:00:56.961Z","dependency_job_id":"097568ca-f74e-4eb1-923f-fbfd76196063","html_url":"https://github.com/doomemacs/core","commit_stats":{"total_commits":18031,"total_committers":834,"mean_commits":21.61990407673861,"dds":"0.29898508124896017","last_synced_commit":"c8a5e6ec1ca85a35f94d6c820c2fd8888373c2ae"},"previous_names":["hlissner/doom-emacs","doomemacs/core"],"tags_count":19,"template":false,"template_full_name":null,"purl":"pkg:github/doomemacs/core","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/doomemacs%2Fcore","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/doomemacs%2Fcore/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/doomemacs%2Fcore/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/doomemacs%2Fcore/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/doomemacs","download_url":"https://codeload.github.com/doomemacs/core/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/doomemacs%2Fcore/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34379915,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-15T02:00:07.085Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["doomemacs","emacs","emacs-configuration","emacs-lisp","evil","vim"],"created_at":"2026-06-10T04:00:24.973Z","updated_at":"2026-06-15T21:00:49.078Z","avatar_url":"https://github.com/doomemacs.png","language":"Emacs Lisp","funding_links":["https://github.com/sponsors/hlissner","https://liberapay.com/hlissner/donate","https://paypal.me/hlissner/10"],"categories":["Emacs Lisp"],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# Doom Emacs\n\n[Install](#install) • [Documentation] • [FAQ] • [Screenshots] • [Contribute](#contribute)\n\n![Made with Doom Emacs](https://img.shields.io/github/tag/doomemacs/core.svg?style=flat-square\u0026label=release\u0026color=58839b)\n![Supports Emacs 27.1–30.2](https://img.shields.io/badge/Supports-Emacs_27.1–30.2-blueviolet.svg?style=flat-square\u0026logo=GNU%20Emacs\u0026logoColor=white)\n![Latest commit](https://img.shields.io/github/last-commit/doomemacs/core?style=flat-square)\n\u003c!-- ![Build status: master](https://img.shields.io/github/workflow/status/doomemacs/core/CI/master?style=flat-square) --\u003e\n[![Discord Server](https://img.shields.io/discord/406534637242810369?color=738adb\u0026label=Discord\u0026logo=discord\u0026logoColor=white\u0026style=flat-square)][discord]\n[![Discussions board](https://img.shields.io/github/discussions/doomemacs/community?label=Discussions\u0026logo=github\u0026style=flat-square)][discuss]\n\n![Doom Emacs Screenshot](https://raw.githubusercontent.com/doomemacs/core/screenshots/main.png)\n\n\u003c/div\u003e\n\n---\n\n### Table of Contents\n- [Introduction](#introduction)\n- [Features](#features)\n- [Prerequisites](#prerequisites)\n- [Install](#install)\n- [Roadmap](#roadmap)\n- [Getting help](#getting-help)\n- [Contribute](#contribute)\n\n\n# Introduction\n\u003ca href=\"http://ultravioletbat.deviantart.com/art/Yay-Evil-111710573\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/doomemacs/core/screenshots/cacochan.png\" align=\"right\" /\u003e\n\u003c/a\u003e\n\n\u003e It is a story as old as time. A stubborn, shell-dwelling, and melodramatic\n\u003e vimmer—envious of the features of modern text editors—spirals into\n\u003e despair before he succumbs to the [dark side][evil-mode]. This is his config.\n\nDoom is a configuration framework for [GNU Emacs] tailored for Emacs bankruptcy\nveterans who want less framework in their frameworks, a modicum of stability\n(and reproducibility) from their package manager, and the performance of a hand\nrolled config (or better). It can be a foundation for your own config or a\nresource for Emacs enthusiasts to learn more about our favorite operating\nsystem.\n\nIts design is guided by these mantras:\n\n+ **Gotta go fast.** Startup and run-time performance are priorities. Doom goes\n  beyond by modifying packages to be snappier and load lazier.\n+ **Close to metal.** There's less between you and vanilla Emacs by design.\n  That's less to grok and less to work around when you tinker. Internals ought\n  to be written as if reading them were part of Doom's UX, and it is!\n+ **Opinionated, but not stubborn.** Doom is about reasonable defaults and\n  curated opinions, but use as little or as much of it as you like.\n+ **Your system, your rules.** You know better. At least, Doom hopes so! It\n  won't *automatically* install system dependencies (and will force plugins not\n  to either). Rely on `doom doctor` to tell you what's missing.\n+ **Nix/Guix is a great idea!** The Emacs ecosystem is temperamental. Things\n  break and they break often. Disaster recovery should be a priority! Doom's\n  package management should be declarative and your private config reproducible,\n  and comes with a means to roll back releases and updates (still a WIP).\n  \nCheck out [the FAQ][FAQ] for answers to common questions about the project.\n\n\n# Features\n- Minimalistic good looks inspired by modern editors.\n- Curated and sane defaults for many packages, (major) OSes, and Emacs itself.\n- A modular organizational structure for separating concerns in your config.\n- A standard library designed to simplify your elisp bike shedding.\n- A declarative [package management system][package-management] (powered by\n  [straight.el]) with a command line interface. Install packages from anywhere,\n  not just (M)ELPA, and pin them to any commit.\n- Optional vim emulation powered by [evil-mode], including ports of popular vim\n  plugins like [vim-sneak], [vim-easymotion], [vim-unimpaired] and\n  [more][ported-vim-plugins]!\n- Opt-in LSP integration for many languages, using [lsp-mode] or [eglot]\n- Support for *many* programming languages. Includes syntax highlighting,\n  linters/checker integration, inline code evaluation, code completion (where\n  possible), REPLs, documentation lookups, snippets, and more!\n- Support for *many* tools, like docker, pass, ansible, terraform, and more.\n- A Spacemacs-esque [keybinding scheme][bindings], centered around leader\n  and localleader prefix keys (\u003ckbd\u003eSPC\u003c/kbd\u003e and \u003ckbd\u003eSPC\u003c/kbd\u003e\u003ckbd\u003em\u003c/kbd\u003e for\n  evil users, \u003ckbd\u003eC-c\u003c/kbd\u003e and \u003ckbd\u003eC-c l\u003c/kbd\u003e for vanilla users).\n- A rule-based [popup manager][popup-system] to control how temporary buffers\n  are displayed (and disposed of).\n- Per-file indentation style detection and [editorconfig] integration. Let\n  someone else argue about tabs vs **_spaces_**.\n- Project-management tools and framework-specific minor modes with their own\n  snippets libraries.\n- Project search (and replace) utilities, powered by [ripgrep] and [ivy] or\n  [helm].\n- Isolated and persistent workspaces (also substitutes for vim tabs).\n- Support for Chinese and Japanese input systems.\n- Save a snapshot of your shell environment to a file for Emacs to load at\n  startup. No more struggling to get Emacs to inherit your `PATH`, among other\n  things.\n\n\n# Prerequisites\n- **Required:**\n  - GNU Emacs 27.1–30.2 (30.2 is recommended)\n    - If only using Doom's core, 27.1+ is required.\n    - If using Doom's modules (especially tree-sitter support), 29.1+ is\n      required.\n  - Git \u003e= 2.23\n  - [ripgrep] \u003e= 11.0\n- **Optional, but recommended:**\n  - [fd] 7.3.0+ (used to improve file indexing performance)\n  - GNU variants of `find`, `ls`, and `tar` (on MacOS and BSD *nix)\n  - Symbola font (Emacs' fallback font for glyphs it can't display)\n\n\u003e [!WARNING]\n\u003e **Avoid unstable and pre-release builds of Emacs.** These end in `.50`, `.60`,\n\u003e or `.9X` (e.g. `28.1.91`). Doom should generally work on Emacs HEAD (the\n\u003e maintainer dogfoods it), but support lags behind the bleeding edge by at least\n\u003e a month or so.\n \n\u003e [!IMPORTANT]\n\u003e Doom is comprised of [~150 optional modules][Modules], some of which may have\n\u003e additional dependencies. [Visit their documentation][Modules] or run `bin/doom\n\u003e doctor` to check for any that you may have missed.\n\n\n# Install\n``` sh\ngit clone --depth 1 https://github.com/doomemacs/core ~/.config/emacs\n~/.config/emacs/bin/doom install\n```\n\nThen [read our Getting Started guide][getting-started] to be walked through\ninstalling, configuring and maintaining Doom Emacs.\n\nIt's a good idea to add `~/.config/emacs/bin` to your `PATH`! Other `bin/doom`\ncommands you should know about:\n\n+ `doom sync` to synchronize your private config with Doom by installing missing\n  packages, removing orphaned packages, and regenerating caches. Run this\n  whenever you modify your private `init.el` or `packages.el`, or install/remove\n  an Emacs package through your OS package manager (e.g. mu4e or agda).\n+ `doom upgrade` to update Doom to the latest release \u0026 all installed packages.\n+ `doom doctor` to diagnose common issues with your system and config.\n+ `doom env` to dump a snapshot of your shell environment to a file that Doom\n  will load at startup. This allows Emacs to inherit your `PATH`, among other\n  things.\n\n\n# Roadmap\nDoom is an active and ongoing project. To make that development more\ntransparent, its roadmap (and other concerns) are published across three github\nproject boards and a newsletter:\n\n- [Development Roadmap](https://doomemacs.org/roadmap)\n- [Packages under review](https://doomemacs.org/packages-under-review):\n  lists plugins we are watching and considering for inclusion, and what their\n  status for inclusion is. Please consult this list before requesting new\n  packages/features.\n+ [Upstream bugs](https://github.com/orgs/doomemacs/projects/7): lists\n  issues that originate from elsewhere, and whether or not we have local\n  workarounds or temporary fixes for them.\n+ ~~Doom's newsletter~~ (not finished) will contain changelogs in between\n  releases.\n  \n\n# Getting help\nEmacs is no journey of a mere thousand miles. You _will_ run into problems and\nmysterious errors. When you do, here are some places you can look for help:\n\n+ [Our documentation][documentation] covers many use cases.\n  + [The Configuration section][configuration] covers how to configure Doom and\n    its packages.\n  + [The Package Management section][package-management] covers how to install\n    and disable packages.\n  + [This section][bin/doom] explains the `bin/doom` script's most important\n    commands.\n  + [This section][common-mistakes] lists some common configuration mistakes new\n    users make, when migrating a config from another distro or their own.\n  + [This answer][change-theme] shows you how to add your own themes to your\n    private config.\n  + [This answer][change-font] shows you how to change the default font.\n  + Your issue may be documented in the [FAQ].\n+ With Emacs built-in help system documentation is a keystroke away:\n  + For functions: \u003ckbd\u003eSPC h f\u003c/kbd\u003e or \u003ckbd\u003eC-h f\u003c/kbd\u003e\n  + For variables: \u003ckbd\u003eSPC h v\u003c/kbd\u003e or \u003ckbd\u003eC-h v\u003c/kbd\u003e\n  + For a keybind: \u003ckbd\u003eSPC h k\u003c/kbd\u003e or \u003ckbd\u003eC-h k\u003c/kbd\u003e\n  + To search available keybinds: \u003ckbd\u003eSPC h b b\u003c/kbd\u003e or \u003ckbd\u003eC-h b b\u003c/kbd\u003e\n+ Run `bin/doom doctor` to detect common issues with your development\n  environment and private config.\n+ Check out the [FAQ] or [Community FAQs][community-faq], in case your question\n  has already been answered.\n+ Search [Doom's issue tracker](https://github.com/doomemacs/core/issues)\n  in case your issue was already reported.\n+ Hop on [our Discord server][discord]; it's active and friendly! Keep an eye on\n  the #announcements channel, where I announce breaking updates and releases.\n\n\n# Contribute\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com) \n[![Elisp styleguide](https://img.shields.io/badge/elisp-style%20guide-purple?style=flat-square)](https://github.com/bbatsov/emacs-lisp-style-guide)\n[![Donate on liberapay](https://img.shields.io/badge/liberapay-donate-1.svg?style=flat-square\u0026logo=liberapay\u0026color=blue)][liberapay]\n[![Donate on paypal](https://img.shields.io/badge/paypal-donate-1?style=flat-square\u0026logo=paypal\u0026color=blue)][paypal]\n\nDoom is a labor of love and incurable madness, but I'm only one guy. Doom\nwouldn't be where it is today without your help. I welcome contributions of any\nkind!\n\n+ I :heart: pull requests and bug reports (see the [Contributing\n  Guidelines][contribute])!\n+ Don't hesitate to [tell me my Elisp-fu\n  sucks](https://github.com/doomemacs/core/issues/new/choose), but please\n  tell me why.\n+ Hop on [our Discord server][discord] and say hi! Help others, hang out or talk\n  to me about Emacs, gamedev, programming, physics, pixel art, anime, gaming --\n  anything you like. Nourish this lonely soul.\n+ If you'd like to support my work financially, buy me a drink through\n  [liberapay] or [paypal]. My work contends with studies, adventures in indie\n  gamedev and freelance work. Donations help me allocate more time to my Emacs\n  and OSS capers.\n\n\n[contribute]: docs/contributing.org\n[discord]: https://doomemacs.org/discord\n[discuss]: https://doomemacs.org/discuss\n[community-faq]: https://github.com/doomemacs/community?tab=readme-ov-file#frequently-asked-questions\n[documentation]: docs/index.org\n[faq]: https://github.com/doomemacs/core/blob/master/docs/faq.org\n[getting-started]: docs/getting_started.org\n[install]: docs/getting_started.org#install\n[backtrace]: docs/getting_started.org#how-to-extract-a-backtrace-from-an-error\n[configuration]: docs/getting_started.org#configuring-doom\n[package-management]: docs/getting_started.org#package-management\n[bin/doom]: docs/getting_started.org#the-bindoom-utility\n[common-mistakes]: docs/getting_started.org#common-mistakes-when-configuring-doom-emacs\n[change-theme]: docs/faq.org#how-do-i-change-the-theme\n[change-font]: docs/faq.org#how-do-i-change-the-fonts\n[modules]: docs/modules.org\n[popup-system]: modules/ui/popup/README.org\n[screenshots]: https://github.com/doomemacs/core/tree/screenshots#emacsd-screenshots\n\n[bindings]: modules/config/default/+evil-bindings.el\n[editorconfig]: http://editorconfig.org/\n[evil-mode]: https://github.com/emacs-evil/evil\n[fd]: https://github.com/sharkdp/fd\n[gnu emacs]: https://www.gnu.org/software/emacs/\n[helm]: https://github.com/emacs-helm/helm\n[ivy]: https://github.com/abo-abo/swiper\n[lsp-mode]: https://github.com/emacs-lsp/lsp-mode\n[eglot]: https://github.com/joaotavora/eglot\n[nix]: https://nixos.org\n[ported-vim-plugins]: modules/editor/evil/README.org#ported-vim-plugins\n[ripgrep]: https://github.com/BurntSushi/ripgrep\n[straight.el]: https://github.com/radian-software/straight.el\n[vim-easymotion]: https://github.com/easymotion/vim-easymotion\n[vim-lion]: https://github.com/tommcdo/vim-lion\n[vim-sneak]: https://github.com/justinmk/vim-sneak\n[vim-unimpaired]: https://github.com/tpope/vim-unimpaired\n\n[liberapay]: https://liberapay.com/hlissner/donate\n[paypal]: https://paypal.me/hlissner/10\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdoomemacs%2Fcore","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdoomemacs%2Fcore","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdoomemacs%2Fcore/lists"}