# harpoon 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. ## Installation Simply install via your favorite plugin manager. ``` Plug 'ThePrimeagen/harpoon' ``` ## Harpooning ### The Basics 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. ### Navigation To start navigating with Harpoon you simply `:call GotoBuffer()`. 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. ### Sending Commands 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 ``` #### Local Configuration example For [VimDeathmatch](https://github.com/VimDeathmatch/server) we have a local config for running commands. Here is an example. ``` nnoremap ce :call SendTerminalCommand(0, "cd ~/personal/VimDeathmatch/server/server && npm run test" . expand("%") . "\n") ``` 1. I have `c` as the start into my local commands. 2. e = middle finger, home row on Dvorak. Power finger. 3. Setup your own commands That means when I am in Deathmatch and I want to test my current file I press 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. #### General Navigation examples Personally I have the following remaps in my root rc. ``` nmap tu :call GotoBuffer(0) nmap te :call GotoBuffer(1) nmap to :call GotoBuffer(2) nmap ta :call GotoBuffer(3) ``` Same concept as before. `t` is my entrence into the terminal world and aoeu is my homerow. All power positions.