Skip to content

cinch.vim

cinch.vim integrates the Cinch CLI into Vim and Neovim so yanked text is pushed to your relay automatically, and you can pull the latest clip without leaving the editor.

  • Vim 8.0+ or Neovim 0.5+
  • cinch CLI installed and authenticated — see the Quick Start guide

lazy.nvim

{ "cinchcli/cinch.vim" }

vim-plug

Plug 'cinchcli/cinch.vim'

With the default configuration, any yank operation pushes the yanked text to your relay:

Key / motionEffect
yyYank line → auto-push
ywYank word → auto-push
y$Yank to end of line → auto-push
any y{motion}Yank → auto-push
CommandDescription
:CinchPullPull the latest clip and insert it at the cursor
:CinchPushManually push the current register to the relay
:CinchToggleToggle auto-push on or off for the current session

All options have sensible defaults. Set them in your config before the plugin loads.

Vim (~/.vimrc)

" Disable auto-push on yank (enable manually with :CinchPush or :CinchToggle)
let g:cinch_auto_push = 0
" Register to push/pull (default: unnamed register)
let g:cinch_push_register = '"'
" Path to the cinch binary if it is not on $PATH
let g:cinch_binary = '/usr/local/bin/cinch'

Neovim (~/.config/nvim/init.lua)

vim.g.cinch_auto_push = 0
vim.g.cinch_push_register = '"'
vim.g.cinch_binary = '/usr/local/bin/cinch'
VariableDefaultDescription
g:cinch_auto_push1Push to relay on every yank
g:cinch_push_register"Vim register used for push and pull
g:cinch_binary'cinch'Path to the cinch binary