Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jannis-baum/si-vim.zsh
Keep a single instance of Vim running and attached to your zsh session
https://github.com/jannis-baum/si-vim.zsh
dotfiles vim zsh
Last synced: about 1 month ago
JSON representation
Keep a single instance of Vim running and attached to your zsh session
- Host: GitHub
- URL: https://github.com/jannis-baum/si-vim.zsh
- Owner: jannis-baum
- Created: 2023-07-09T10:41:39.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-05-13T13:39:10.000Z (9 months ago)
- Last Synced: 2024-11-14T06:52:52.979Z (3 months ago)
- Topics: dotfiles, vim, zsh
- Language: Shell
- Homepage:
- Size: 14.6 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# si-vim
Keep a single instance of Vim running & attached to each interactive Zsh
session. This enables you to switch back and forth between Vim and Zsh
instantly.
## Features
- automatically keep an instance of Vim running for each interactive Zsh session
- use `siv` or your own keybinding to go to Vim, use `:sus[pend]` (or a
keybinding) to go back to Zsh
- open files from Zsh with `siv`, this will open Vim and
- switch to the corresponding buffer if the file was already open, or
- open the file in a new tab if it wasn't yet open
- automatically keep the working directory of Zsh & Vim in sync, i.e. whenever
you change your directory in Zsh, the attached si-vim session will switch as
well
- exiting `zsh` with `ctrl-d` will warn you in case you have unsaved changes in
Vim and otherwise exit cleanly (you can disable this behavior by setting
`$SI_VIM_NO_CTRL_D` before sourcing this plugin).
- disable/enable automatically keeping Vim open with `siv-[en|dis]able` or by
setting/unsetting the environment variable `$SI_VIM_DISABLED`
- `siv` also supports running startup commands from arguments with the `+`
prefix like Vim and will create all directories that don't exist for the given
file path
### Keybindings
I recommend setting a keybinding to switch back and forth between Zsh and Vim.
To do this with `ctrl-u`, for example, add the following to your `.zshrc`
```zsh
bindkey ^u _si_vim_widget
```
and to your `.vimrc`
```vimscript
nnoremap :suspend
```
Furthermore, depending on how you usually exit Vim, you will probably want to
reconfigure it to only close all buffers and suspend Vim instead of quitting it.
I like doing this with `ZZ`, and keep the following in my `.vimrc`
```vimscript
nnoremap :bufdo bw:sus
```
## Installation
To use this plugin, simply source all `.zsh` files from this repo in your
`.zshrc`, for example like this
```zsh
for script in $(find '' -name '*.zsh'); do
source $script
done
```
and all `.vim` files in your `.vimrc`, for example like this
```vimscript
for f in glob($HOME . '/**/*.vim', 0, 1)
execute 'source ' . f
endfor
```
I do this by keeping this repository as a submodule in my
[dotfiles](https://github.com/jannis-baum/dotfiles.git). If you want to do this,
I recommend using my tool
[`sdf`](https://github.com/jannis-baum/sync-dotfiles.zsh) to manage your
dotfiles and their dependencies.