mirror of
https://github.com/ThePrimeagen/harpoon.git
synced 2025-07-14 10:00:29 +00:00
54 lines
2.0 KiB
Markdown
54 lines
2.0 KiB
Markdown
<div align="center">
|
|
|
|
# Harpoon
|
|
##### Getting you where you want with the fewest keystrokes.
|
|
|
|
[](http://www.lua.org)
|
|
[](https://neovim.io)
|
|
</div>
|
|
|
|
|
|
-- image provided by **Bob Rust**
|
|
|
|
## ⇁ TOC
|
|
[Note to legacy Harpoon 1 users](/#Note%20to%20legacy%20Harpoon%201%20users)
|
|
[The Problems:](/#The%20Problems:)
|
|
[ The Solutions:](/#%20The%20Solutions:)
|
|
[Installation](/#Installation)
|
|
[Getting Started](/#Getting%20Started)
|
|
[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)
|