Go to file
Caleb Maclennan 1b38911c40 Disallow chaining VimuxRunCommand and VimuxPromptCommand
Fixes #185

Vim does not allow escaping some characters in commands that can be
chained. In particular bars are disallowed and double quotes begin code
comments. Both of these things are regular features in shell command
strings.

I'm disallowing chaining for the two commands that take shell commands
as arguments so they can be used sensibly again. One solution to allow
this might be to have a ...Bar version of each. It might also be
possible to work around this with `:call` and functions instead of
commands.
2021-02-18 23:38:53 +03:00
.github/workflows Split PR review from branch check workflows 2021-02-18 08:34:30 +03:00
doc docus: Copy edit help docs with fresh link and to remove 1st person 2021-02-18 07:48:50 +03:00
plugin Disallow chaining VimuxRunCommand and VimuxPromptCommand 2021-02-18 23:38:53 +03:00
.gitignore rm tags file and .gitignore it. 2012-05-31 17:44:50 +02:00
.vintrc.yaml Add Vint config file for vimscript linting 2021-02-14 16:39:31 +03:00
LICENSE Fix typo and bump license date range, closes #154 2021-02-14 10:21:21 +03:00
README.md docs: Promote usage links in readme and remove help doc specific copy 2021-02-18 07:47:28 +03:00

Vimux: easily interact with tmux from vim

Vint

vimux

Vimux was originally inspired by tslime.vim, a plugin that lets you send input to tmux. While tslime.vim works well, it wasn't optimized for the use case of having a smaller tmux pane used to run tests or play with a REPL. The goal of Vimux is to make interacting with tmux from vim effortless.

By default, when you call VimuxRunCommand vimux will create a 20% tall horizontal pane under your current tmux pane and execute a command in it without losing the focus on vim. Once that pane exists, whenever you call VimuxRunCommand again the command will be executed in that pane. A frequent use case is wanting to rerun commands over and over. An example of this is running the current file through rspec. Rather than typing that over and over VimuxRunLastCommand will execute the last command called with VimuxRunCommand.

Installation

With vim-bundle: vim-bundle install preservim/vimux With Vundle: Plugin 'preservim/vimux' in your .vimrc

Otherwise download the latest tarball, extract it and move plugin/vimux.vim inside ~/.vim/plugin. If you're using pathogen, then move the entire folder extracted from the tarball into ~/.vim/bundle.

Notes:

  • Vimux assumes a reasonably new version of tmux. Some older versions might work but it is recommended to use the latest stable release.

Usage

The full documentation is available online and accessible inside vim via :help vimux

Platform-specific Plugins