github github
star 40
alert-circle 0
users 4
git-branch 4



4 days ago


mooD Nvim is a configuration made for those who wants to install and use, without worries.

image 1 image 2 image 3 image 4 image 5


  • 100% on Lua
  • IDE Features: LSP, snippets, autocomplete, go to definition, go to references, etc.
  • Handbook (SPC h h) and Tutorial (SPC h T) natively. Most of cool feature are listed there.
  • Awesome Test Runner.
  • Fully customizable by user (plugins, settings, LSP)
  • Find In Folder helpers: Find inside models, controller, etc using keybindngs. See keybindings.lua (SPC f p) for more examples. You can define your own custom finders.
  • TMUX Framework with tmux-awesome-manager that can:
    • You can bind terminal commands in your keybindings.lua (SPC f p).
    • Useful for commands such as rails console, server, sidekiq, yarn start, generate, open production stuff, etc. (Examples on keybindings.lua)
    • You can define server terminal commands separated by project and run with a single command.


This configuration is made to use with Alacritty and Tmux. Please install it and learn before use it.

Breaking Changes

After last upgrade (21/01/2023), you need to do some stuff:

Run at your terminal:

rm -rf ~/.config/nvim/lua/user/lsp.lua

rm -rf ~/.config/nvim/plugin/packer_compiled.lua

rm -rf ~/.local/share/nvim


  • Neovim >= 0.8 <= 0.9
  • lazygit
  • ripgrep
  • NerdFonts
  • Python

Automatic Installation

We created a bash script to make your life easier and install Mood Nvim automatically. Just run the below command in the terminal on either mac or linux, choose what you want to install and have fun!

bash <(curl -Ls https://raw.githubusercontent.com/otavioschwanck/mood-nvim/main/bin/mood-installer.sh)

If you will use tmux, after the first open, press C-x I to install the packages.

To install manually, check the page: https://github.com/otavioschwanck/mood-nvim/wiki/Manual-Installation#manual-installation

After install

  • Check if is missing something with :checkhealth

How to learn the keybindings of this configuration?

Just press SPC h h to open the handbook inside vim.