HackerReposA FIELD GUIDE TO OPEN SOURCE
ProSponsor the shelf♧ 0
← Back to top all-time
syl20bnr
spacemacs
Emacs Lisp2014–2023
syl20bnr / spacemacs

spacemacs

A community-driven Emacs distribution - The best editor is neither Emacs nor Vim, it's Emacs *and* Vim!

79Distinct people
93Mentions
2Explicit recommenders
24.6KGitHub stars
REPOSITORY AT A GLANCE

What to know before exploring

What it is

A community-driven Emacs distribution - The best editor is neither Emacs nor Vim, it's Emacs *and* Vim!

GitHub

Where it is used

No documented product use was verified in the last source check.

What people are saying

I've been using Emacs for everything since highschool and through University and my career. The best way to get used to it is to bootstrap with tutorials and then just keep…

dpbriggs used a recommendation phrase. 2 indexed comments match. This is a phrase match, not a verdict.

No classified warning is attached to this page. Read the discussions before treating silence as approval.

Also in these discussions

Mentioned in the same Hacker News threads. That is not proof they are substitutes.

This week on Hacker News

Nov 9–Nov 16 UTC · Direct repository links and separately labeled related project stories. Indexed through 11/16/2026, 7:27:27 AM UTC.

No direct repository links were found in the indexed HN discussions over the past seven days. Older discussions are available below.

Mentions over time

HN mentions by year93 dated mentions

Observed mentions: 2014-11-17 03:40:37 UTC to 2023-09-07 09:08:04 UTC.

01020302014-01-01 00:00:00 UTC to 2015-01-01 00:00:00 UTC (exclusive): 11 mentions; 2 submissions, 9 comments20142015-01-01 00:00:00 UTC to 2016-01-01 00:00:00 UTC (exclusive): 32 mentions; 4 submissions, 28 comments2016-01-01 00:00:00 UTC to 2017-01-01 00:00:00 UTC (exclusive): 19 mentions; 2 submissions, 17 comments2017-01-01 00:00:00 UTC to 2018-01-01 00:00:00 UTC (exclusive): 8 mentions; 1 submissions, 7 comments2018-01-01 00:00:00 UTC to 2019-01-01 00:00:00 UTC (exclusive): 5 mentions; 0 submissions, 5 comments20182019-01-01 00:00:00 UTC to 2020-01-01 00:00:00 UTC (exclusive): 5 mentions; 0 submissions, 5 comments2020-01-01 00:00:00 UTC to 2021-01-01 00:00:00 UTC (exclusive): 4 mentions; 0 submissions, 4 comments2021-01-01 00:00:00 UTC to 2022-01-01 00:00:00 UTC (exclusive): 2 mentions; 0 submissions, 2 comments2022-01-01 00:00:00 UTC to 2023-01-01 00:00:00 UTC (exclusive): 4 mentions; 0 submissions, 4 comments2023-01-01 00:00:00 UTC to 2024-01-01 00:00:00 UTC (exclusive): 3 mentions; 0 submissions, 3 comments2023

Counts come from the repository’s dated source evidence. Index cutoff: 2026-11-02 08:16:59 UTC.

View mention counts and date ranges
UTC ranges include their start and exclude their end. Select a period to filter the source evidence.
PeriodStart (UTC)End (exclusive, UTC)MentionsSubmissionsComments
20142014-01-01 00:00:00 UTC2015-01-01 00:00:00 UTC1129
20152015-01-01 00:00:00 UTC2016-01-01 00:00:00 UTC32428
20162016-01-01 00:00:00 UTC2017-01-01 00:00:00 UTC19217
20172017-01-01 00:00:00 UTC2018-01-01 00:00:00 UTC817
20182018-01-01 00:00:00 UTC2019-01-01 00:00:00 UTC505
20192019-01-01 00:00:00 UTC2020-01-01 00:00:00 UTC505
20202020-01-01 00:00:00 UTC2021-01-01 00:00:00 UTC404
20212021-01-01 00:00:00 UTC2022-01-01 00:00:00 UTC202
20222022-01-01 00:00:00 UTC2023-01-01 00:00:00 UTC404
20232023-01-01 00:00:00 UTC2024-01-01 00:00:00 UTC303

From the project README

An excerpt from the repository, fetched Nov 13, 2026.

Read the project’s introduction
philosophy | for whom? | screenshots | documentation | contribute | achievements | FAQ Quick Start If you don't have an existing Emacs setup and want to run Spacemacs as your configuration, and if you have all prerequisites installed, you can install Spacemacs with one line: shell: git clone https://github.com/syl20bnr/spacemacs "${HOME}/.emacs.d" Windows PowerShell: git clone https://github.com/syl20bnr/spacemacs "${HOME}/.emacs.d" If HOME is not set in environment or in registry: git clone https://github.com/syl20bnr/spacemacs "${env:APPDATA}/.emacs.d" If you do have an existing Emacs configuration, look at the full installation instructions for other options. Introduction Spacemacs is a new way of experiencing Emacs -- it's a sophisticated and polished set-up, focused on ergonomics, mnemonics and consistency. Just clone and launch it, then press the space bar to explore the interactive list of carefully-chosen key bindings. You can also press the home buffer's [?] button for some great first key bindings to try. Spacemacs can be used naturally by both Emacs and Vim users -- you can even mix the two editing styles. Being able to quickly switch between input styles, makes Spacemacs a great tool for pair-programming. Spacemacs is currently in beta, and any contributions are very welcome. Features Great documentation: access the Spacemacs documentation with SPC h SPC. Beautiful GUI: you'll love the distraction free UI and its functional mode-line. Excellent ergonomics: all the key bindings are accessible by pressing the SPC or Alt-m. Mnemonic key bindings: commands have mnemonic prefixes like SPC b for all the buffer commands or SPC p for the project commands. Batteries included: discover hundreds of ready-to-use packages nicely organized in configuration layers following a set of conventions . Documentation Comprehensive documentation is available for each layer by pressing SPC h SPC. You can also check the general documentation, quick start guide and the FAQ. Getting Help If you need help, ask your questions in the Gitter Chat and a member of the community will help you out. If you prefer IRC, connect to the Gitter Chat IRC server and join the #syl20bnr/spacemacs channel. Last but not least there are a lot of high class tutorials available on YouTube: Jack of Some's Spacemacs tutorial videos. GDQuest's Game Design oriented tutorials to Spacemacs. Practicalli's Clojure tutorials based on Spacemacs. Eivind Fonn's classic Spacemacs ABC. Prerequisites A package manager if the OS doesn't have one already. Spacemacs is an extension of a popular text editor called Emacs. So you'll need Emacs installed first. Spacemacs requires Emacs 28.2 or above. The development version of Emacs is not officially supported, but it should nevertheless be expected to work. git is required to download and update Spacemacs. Tar, in particular GNU Tar, is required to install and update Emacs packages used by Spacemacs. (Optional) The default font used by Spacemacs is Source Code Pro. You may customize your own font settings and choose another font. If you want to use this default font, it must be installed. Spacemacs also uses fallback fonts to ensure certain Unicode symbols it uses symbols appear correctly. The fonts used are determined by the OS: Linux: Nanum Gothic macOS: Arial Unicode MS Windows: MS Gothic and Lucida Sans Unicode If the mode-line doesn't look similar to the picture at the top of this page, make sure you have the correct fallback font installed. (Optional) Various commands in Spacemacs needs one of the following line searching program: ripgrep (rg) The silver searcher (ag) ack GNU Grep or BSD Grep Grep is very slow but it's widely available on most systems and is used as an fallback option. We strongly recommend ripgrep over other line searching programs, for its blazing fast speed. The following subsections helps you to install it. Linux Most Linux distribution ships a package manager already and if this is the case you are all set for this step. If it doesn't, you may need to build the software mentioned below from their sources. In most distributions, Emacs is installed via an emacs package from the package manager. N.B. DO not install XEmacs because it's not supported by Spacemacs. XEmacs is an old fork of Emacs with various subtle differences. N.B. Some Linux distributions support only Emacs versions older than 28.2. In this case you should build it from source instead. Very likely Git is already installed on your system. Otherwise, you should be able to install git from your system's package manager. Very likely Tar is already installed on your system. Otherwise, you should be able to install tar from your system's package manager. (Optional) If Nerd Fonts and Nanum Gothic are available from your distribution's package manager, you should install it there. Otherwise, the generic way to install it is: Download the latest pre-built TTF font from https://github.com/adobe-fonts/source-code-pro/releases/latest and https://fonts.google.com/specimen/Nanum+Gothic. Extract the archive and move the font files to ~/.fonts. Refresh font cache with: fc-cache -fv (Optional) If your distribution is listed here, follow the instructions to install ripgrep (rg). Otherwise, you can download its pre-built binary or build it from source. macOS The most popular package manager on macOS is Homebrew, to install it: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" Several options exist for installing Emacs on macOS: Emacs Plus features additional functionalities over base Emacs. brew tap d12frosted/emacs-plus # install latest stable release, with Spacemacs icon and native compilation brew install emacs-plus --with-spacemacs-icon --with-native-comp You will require the latest version of Xcode Command Line tools, which can be downloaded from the Apple Developer Portal or by running the following comm
Read the full README on GitHub

What Hacker News says

11 sources
Yeah, like I mentioned on this page, I've been using Emacs for almost 30 years. In that time, I've heard the "right tool for the right job" expression so much that it almost makes me ill. It offers little value. The silly metaphors add no value either. Now, back to my point, if you're writing a book about mastering Emacs, like we are discussing, one of its main weaknesses is out of the box code-completion. Many new users would be well served by covering this topic. I've shown Emacs to many people over the years that's one of the biggest complaints. Hippie expansion wasn't going to cut it. Btw, it seems many other people share my attitude and there are "Batteries Includes" versions of Emacs. https://github.com/syl20bnr/spacemacs/blob/master/doc/DOCUME...
In “Mastering Emacs” ebook announced
> Yes (ctrl+alt+up). Does it work in the source as large as the linux kernel that shows you every possible files? i.e I have a file named `fpu.c`, I want all `fpu.h` in Linux. And Emacs does not work with only C/C++, but work for any languages that users define two lists of pairs of file extensions to switch to. i.e. you can switch between Gemfile <-> Gemfile.lock, .h <-> .js... > I'm not sure I understand. I mentioned fuzzy completion before, the way it works is that it matches even subparts of the paths and/or filename, with the only requisite of preserving left to right. For instance if I type "bmx25" I can find boot-related imx25 files, because it will match the "b" from the boot path, and then "mx25" from the filename (even a few directories down the path). No. I mean that in an ASCII text file, with only the filename (no path inform
Read the rest
ation), you press a key binding, it automatically jumps to that fine. For example, I have a file "Document/test.txt". In "src/feature1/test.c", it only mentions "test.txt". I want that when cursor is on "test.txt", and if that file is the only file in my project, I jump to it instantly; otherwise, it gives me a list of potential candidates. And this must work in any file, even plain ASCII text file. If the text at point is a directory path, I expect with a single key stroke, my editor returns all files that contain that path. > So it depends whether you want to compare the richness of the ecosystem or the core capabilities of the editor. Both. After all, Emacs is a Lisp interpreter at its core. It's a computing environment more than a text editor; text editing is just a subset of it. That's why it is so easy to write tools for Emacs, despite a much lesser user base than other editors. Emacs has many hidden things that I can never find in other editors. For example, it has an advanced calculator and mathematical tool roughly based on the HP-28/48 : http://www.gnu.org/software/emacs/manual/html_mono/calc.html > I honestly don't know; it doesn't that by default, though there might be some plugin to that effect; when I use compiled languages, I prefer a linter-like approach to showing compilation errors, so I don't use this kind of plugins in my own environment Emacs supports coloring compile output by default, built-in. Emacs also has a syntax check plugin for wide array of languages, called flycheck: https://github.com/flycheck/flycheck (see the homepage for a simple demo). And here is GDB inside Emacs: tuhdo.github.io/static/c-ide/gdb-many-windows.gif Every change you make to a value, all other panes update as well, when relevant. You can also have an integrated memory debugger inside Emacs. You can even do remote debugging with Emacs. > yes, this is supported, though I personally switched to Dash (http://kapeli.com/dash) recently, which is similar but much more powerful than just man, as it allows to cache and index documentation from dozens of programming environment and frameworks, taking care of the different formats, etc. So for instance with the same shortcut I can get the help for a POSIX function from its man page, or a Boost class method from their official documentation, and everything is blazingly fast because of local cache and index, so my computer doesn't need to go to boost.org to show that page. Emacs has support for Dash as well, and you can view it inside Emacs: https://github.com/areina/helm-dash > You can do that in Sublime, but you need to define a project (which, in its most basic form, is just a "save project" command after having opened a directory); at that point, you have a shortcut to switch between projects with fuzzy completion, and each project keeps the full workspace, ALSO including unsaved modifications to files (which sounds crazy but I love it) as it means that you can do it without even thinking once. Emacs can do that as well. You can switch between projects, and Emacs remembers window layout of each project you are working on with Projectile: https://github.com/bbatsov/projectile. You can see more Projectile demos in my guide (demos at top): http://tuhdo.github.io/helm-projectile.html What I said is very different. You think each Emacs window is like a perspective in Eclipse. Each window layout can have different purposes: it can be a layout of 4 smaller code buffers, or it can be a debug view, or it can hold many documentation panes... You can arrange arbitrary window layouts, save and restore in future sessions. You can group many window layouts (or "perspectives") inside a workspace, and you can also have many workspaces like that. Each workspace can be a project, each has many different layouts for different purposes. > Generally speaking, I don't think there's a world of difference. I find vim harder to replicate in its more advanced features, with its approach to command combinations which is totally different from anything else; but emacs introduced to the world the concept an extendible editor based on complicated, targeted commands (which is the one in widespread usage today), so I think that any sufficiently advanced editor can get very close to emacs in most features. Vim is now a proper subset of Emacs. Evil is the best Vim emulator out there, said Vimmers who switched to Emacs. See Spacemacs: https://github.com/syl20bnr/spacemacs > If look at Atom for instance, they introduced a concept where the editor window is not simply line-based, but they can open graphical windows within it, which is a paradigm shift which might introduce unique features, very hard to replicate. See for instance their nested CSS editing feature, which is very nice because it helps my brain limit the context switching a lot. Yet Atom cannot work in terminal, which is essential for working remotely. Emacs can live to this day because it has 30 years of accumulating vast amount of different uses cases. Someday someone will add such capacities to Emacs, when it is really needed. For now, graphic is cute but it mostly satisfies web development. If I have 10 or 20 local VMs (with only terminal), it would be crazy without Emacs to manage all of them effortlessly.
In Stack Exchange for Emacs
After a long time of maintaining my own configuration I took the decision a few years ago to outsource it to people who really care about this stuff. I started with the Emacs Prelude (http://batsov.com/prelude/) which introduced me to some great tools. I recently switched to Vim bindings (evil-mode) and a week ago switched to Spacemacs (https://github.com/syl20bnr/spacemacs) which integrates better with evil-mode . So far I'm really liking the Spacemacs approach. tl;dr: Just use one of the packaged Emacs configs unless you really care about this stuff.
In Making Emacs Work for Me
You can check https://github.com/syl20bnr/spacemacs if you want to use Evil mode not just for editing but for everything else in Emacs. Just clone to your ~/.emacs.d and start Emacs then everything will be automatically installed for you. Most key bindings outside of editing are Vim-like, created by Vim users. You already stick with Vim for 10 years and learned many things about, so I suggest you to keep that knowledge. But then, aside of editing text, if some Emacs utility does not have Evil key bindings, you should also learn the default, because most of the utilities are always in normal mode, so you only need to press a single key to execute most commands. spacemacs also has extensive documentation, so you can learn key bindings easily and be productive with Emacs immediately without any extra configuration.
In Emacs Rocks

MAKE YOURSELF AT HOME

A few shortcuts

/
Search the collection
?
Open this guide
Esc
Close dialogs and navigation

Your saved repositories and interests stay in this browser.