intellimacs

intellimacs copied to clipboard

#+TITLE: Intellimacs

[[http://spacemacs.org][file:https://cdn.rawgit.com/syl20bnr/spacemacs/442d025779da2f62fc86c2082703697714db6514/assets/spacemacs-badge.svg]]

[[file:docs/preview.gif]]

• Presentation This project tries to mimic [[http://spacemacs.org][Spacemacs]] key bindings in IDEs based on the [[https://www.jetbrains.com][IntelliJ]] platform, i.e. IntelliJ IDEA, PyCharm, CLion, PhpStorm, WebStorm, RubyMine, AppCode, DataGrip, GoLand, Rider, Cursive, and Android Studio.

For instance, ~SPC f f~ in Spacemacs opens a file, so it makes sense to map it to the "GotoFile" IntelliJ action.

• How it works This project can be seen as a set of configuration files for the [[https://plugins.jetbrains.com/plugin/164-ideavim][IdeaVim]] plugin, which enables vim emulation inside IntelliJ platform. =~/.ideavimrc= is the file where IdeaVim lets you add Vim initialization commands, i.e. this file is like =~/.vimrc= for vim.

IdeaVim parses the [[https://github.com/JetBrains/ideavim/blob/master/src/com/maddyhome/idea/vim/package-info.java][most common]] vim commands, together with the custom =:action {name}= command, used to execute arbitrary IDE actions. To list all IDE actions use the command =:actionlist [pattern]=.

Intellimacs provides different files, which can be included individually in your own =.ideavimrc=, in order to get only the functionalities you want.

• Key bindings Intellimacs is composed of three modules:

• spacemacs :: Contains Spacemacs settings and key bindings that can be replicated with a similar behaviour in the IntelliJ platform.
• extra :: Contains settings and key bindings not present in Spacemacs, but that may be useful in the IntelliJ platform.
• major :: Contains key bindings that start with ~SPC m~, that may or may not be present in some Spacemacs major mode.

Furthermore, Intellimacs provides some of the features of Spacemacs hybrid mode, which may be enabled by sourcing the file =~/.intellimacs/hybrid.vim=.

Read [[file:docs/KEYBINDINGS.org][KEYBINDINGS.org]] to see all 200+ available key bindings.

• Installation

1. Go to the IDE's plugin manager (File -> Settings -> Plugins) and install the following plugins:
   • [[https://plugins.jetbrains.com/plugin/164-ideavim][IdeaVim]]: vim emulation
   • (Optional) [[https://plugins.jetbrains.com/plugin/15976-idea-which-key][IDEA Which-Key]]: menu that shows the available commands as you type
2. Clone this repository in your home directory: #+begin_src sh git clone https://github.com/MarcoIeni/intellimacs ~/.intellimacs #+end_src
3. In your home directory, create the file =.ideavimrc= and edit it in order to include the modules you want by sourcing the relative source files. In the following there is an example of =.ideavimrc= file that includes all the functionalities offered by Intellimacs. In this file you can also include your own vim commands. #+begin_src vimrc source ~/.intellimacs/spacemacs.vim

" (Optional) Enable other Intellimacs modules source ~/.intellimacs/extra.vim source ~/.intellimacs/major.vim source ~/.intellimacs/hybrid.vim

" (Optional) Enable which-key plugin source ~/.intellimacs/which-key.vim

" (Optional) My own vim commands nnoremap Y y$

" (Optional) Comma for major mode nmap , m vmap , m

" (Optional) Add/edit actions nnoremap gl :action Vcs.Show.Log<CR> vnoremap gl :action Vcs.Show.Log<CR> #+end_src 4. (optional) source your vimrc file by adding the line =source ~/.vimrc= in =.ideavimrc= (you may break something).

• Update In order to update run =git pull= inside the intellimacs directory.

Read [[file:docs/CHANGELOG.org][CHANGELOG.org]] to see what changed.

• Suggested plugins [[file:docs/PLUGINS.org][PLUGINS.org]] contains a list of useful plugins that help to replicate the Spacemacs experience.

• Tips

** Go back to code The key bindings work only when you are inside the code. For example, if you are inside the project window they don't work. Press ~<Esc>~ to focus the last visited code window and you will be able to use spacemacs key bindings again.

** Scroll menus without arrow keys In order to scroll menus without using arrow keys, press ~SPC f e d~ to go to IDE's settings and set a custom shortcut for the actions =Down= and =Up= in the menu =Keymap -> Editor Actions=. For example, you can bind them respectively to =Ctrl + j= and =Ctrl + k=. If you have some conflicts, search the editor action the key is assigned to, right click and remove the binding.

** Open a file in Emacs with keyboard shortcut In order to open a file in Emacs with a keyboard shortcut follow [[https://www.jetbrains.com/help/idea/using-emacs-as-an-external-editor.html][this]] guide.

• Resources

• [[https://github.com/JetBrains/ideavim][IdeaVim]]
• [[https://resources.jetbrains.com/storage/products/intellij-idea/docs/IntelliJIDEA_ReferenceCard.pdf][Intellij default keymap]]
• [[https://www.jetbrains.com/help/idea/sharing-your-ide-settings.html#settings-repository][Share IDE settings]]

• Contributions Intellimacs needs you to keep it up to date and propose great and useful key bindings.

Before contributing, be sure to read [[file:docs/CONTRIBUTING.org][CONTRIBUTING.org]] first!

• Related projects

• [[https://github.com/MarcoIeni/spaceclipse][Spaceclipse]] - Spacemacs' like key bindings for Eclipse
• [[https://github.com/SpaceVim/SpaceVim][SpaceVim]] - A community-driven modular vim distribution
• [[https://github.com/VSpaceCode/VSpaceCode][VSpaceCode]] - Spacemacs' like key bindings for Visual Studio Code (thanks for the inspiration)