Harpoon is a terminal navigator for Neovim (currently, but I want vim to work as well). Harpoon itself does not provide much for functionality other than goto a terminal, set a terminal, and sending commands. Where it shines is in local configs.
Simply install via your favorite plugin manager.
Plug 'ThePrimeagen/harpoon'
Harpoon provides up to 4 slots for terminals. Now you don't want to overload
terminals with everything. I just tend to think about this as project specific
tasks. Such as, yarn lint, yarn test, or some command based off of current
file.
Personally I only use 1 terminal. I have no use for multiple terminals, but it does provide the hooks for that.
To start navigating with Harpoon you simply :call GotoBuffer(<bufnu>). This
will create / navigate to the terminal in current buffer.
bufnu: can be a number from 0 - 3. As stated above, there are up to 4 slots.
Where Harpoon shines is in local configs.
To setup a local config (per project) you must have a .nvimrc in the root of
your project (where you open up vim) and you must have the following sets in your root vimrc.
set exrc
set secure "optional, but it prevents harmful scripts from editing
"I don't have this option on
For VimDeathmatch we have a local config for running commands. Here is an example.
nnoremap <leader>ce :call SendTerminalCommand(0, "cd ~/personal/VimDeathmatch/server/server && npm run test" . expand("%") . "\n")<CR>
- I have
cas the start into my local commands. - e = middle finger, home row on Dvorak. Power finger.
- Setup your own commands
That means when I am in Deathmatch and I want to test my current file I press
<leader>ce and it will open a terminal if there isn't one opened and execute
the commands. I could of made that command a lot better, I was just in a hurry
:) Forgive me.
Personally I have the following remaps in my root rc.
nmap <leader>tu :call GotoBuffer(0)<CR>
nmap <leader>te :call GotoBuffer(1)<CR>
nmap <leader>to :call GotoBuffer(2)<CR>
nmap <leader>ta :call GotoBuffer(3)<CR>
Same concept as before. t is my entrence into the terminal world and aoeu is
my homerow. All power positions.