# Harpoon ##### Getting you where you want with the fewest keystrokes. [![Lua](https://img.shields.io/badge/Lua-blue.svg?style=for-the-badge&logo=lua)](http://www.lua.org) [![Neovim](https://img.shields.io/badge/Neovim%200.5+-green.svg?style=for-the-badge&logo=neovim)](https://neovim.io)
![Harpoon](harpoon.png) -- image provided by **Bob Rust** ## ⇁ TOC * [Note to legacy Harpoon 1 users](#-Note-to-legacy-Harpoon-1-users) * [The Problems](#-The-Problems) * [The Solutions](#-The-Solutions) * [Installation](#-Installation) * [Getting Started](#-Getting-Started) * [Social](#-Social) ## ⇁ Note to legacy Harpoon 1 users Original Harpoon will remain in a frozen state and i will merge PRs in with _no code review_ for those that wish to remain on that. Harpoon 2 is significantly better and allows for MUCH greater control. Please migrate to that (will become `master` within the next few months). ## ⇁ The Problems 1. You're working on a codebase. medium, large, tiny, whatever. You find yourself frequenting a small set of files and you are tired of using a fuzzy finder, `:bnext` & `:bprev` are getting too repetitive, alternate file doesn't quite cut it, etc etc. 1. You want to execute some project specific commands or have any number of persistent terminals that can be easily navigated to. ## ⇁ The Solutions 1. The ability to specify, or on the fly, mark and create persisting key strokes to go to the files you want. 1. Unlimited terminals and navigation. ## ⇁ Installation * neovim 0.5.0+ required * install using your favorite plugin manager (`vim-plug` in this example) ```vim Plug 'nvim-lua/plenary.nvim' " don't forget to add this one if you don't have it yet! Plug 'ThePrimeagen/harpoon' ``` ## ⇁ Getting Started ## ⇁ Social For questions about Harpoon, there's a #harpoon channel on [the Primagen's Discord](https://discord.gg/theprimeagen) server. * [Discord](https://discord.gg/theprimeagen) * [Twitch](https://www.twitch.tv/theprimeagen) * [Twitter](https://twitter.com/ThePrimeagen)