lazy-idea

LazyVim key mappings for JetBrains IDEs. Making IdeaVim feel like home.

Prerequisites

Required plugins from the JetBrains Marketplace:

• IdeaVim
• Which-Key
• EasyMotion

Optional plugins from the JetBrains Marketplace:

• LazyGit

Installation

Clone the repository to ~/.lazy-idea:

Unix/Linux/macOS

git clone https://github.com/cufarvid/lazy-idea.git ~/.lazy-idea

Windows (PowerShell)

git clone https://github.com/cufarvid/lazy-idea.git "$HOME/.lazy-idea"

Then add the following line to your ~/.ideavimrc (create it if it doesn't exist):

source ~/.lazy-idea/lazy-idea.vim

Any custom settings, plugins, or overrides you add after the source line will take precedence. Then restart your JetBrains IDE.

Development

Notes and Caveats

• Not all mappings have been thoroughly tested
• Potential ctrl key conflicts: 6, b, e, f, h, j, k, l, o, r, s, v, w
  • See IdeaVim sethandler documentation

Roadmap

• Improve Todo comments functionality
• Add Which-Key labels for all mappings
• Test all mappings side-by-side with LazyVim

Future Considerations

Potential integrations with LazyVim features:

• Flash
• Noice
• Trouble
• Mini.diff
• Harpoon
• Outline
• Markdown Preview

Issues and Limitations

• Local leader key mappings are not currently supported by IdeaVim
• Some LazyVim features don't have direct equivalents in JetBrains IDEs
• The TODO navigation keymaps (<leader>st, <leader>xt) use IDEA's built-in TODO tool window. To support additional patterns beyond TODO (like FIX or PERF), configure them in Settings → Editor → TODO → Patterns.

Credits

• Original gist by @mikeslattery
• LazyVim by @folke