Skip to content

A neovim plugin allowing you to easily send lines from the current buffer to another kitty terminal

License

Notifications You must be signed in to change notification settings

LkeMitchll/kitty-runner.nvim

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

51 Commits
 
 
 
 
 
 
 
 

Repository files navigation

kitty-runner.nvim

This neovim plugin allows you to easily send lines from the current buffer to another kitty terminal. I use it mostly as a poor man's REPL, e.g. I start ipython in the kitty terminal and send buffer lines to it.

This plugin is inspired by and heavily borrows from vim-kitty-runner.

If you run into trouble using the plugin or have suggestions for improvements, do open an issue! :)

Functionality

The plugin implements the following commands:

  • :KittyOpenRunner: Open a new kitty terminal (called a runner in the context of this plugin)
  • :KittySendLines: Send the line at the current cursor position or the lines of current visual selection
  • :KittyRunCommand: Prompt for a command and send it
  • :KittyReRunCommand: Send the last command
  • :KittyClearRunner: Clear the runner's screen
  • :KittyKillRunner: Kill the runner
  • :KittyFocusRunner: Focus the runner window, if one exists

By default a number of keymaps are created (see below to turn this off):

  • <leader>to: :KittyOpenRunner
  • <leader>tr: :KittyRunCommand
  • <leader>ts: :KittySendLines
  • <leader>tl: :KittyReRunCommand
  • <leader>tc: :KittyClearRunner
  • <leader>tk: :KittyKillRunner
  • <leader>tf: :KittyFocusRunner

Environment Variable

kitty-runner sets $IS_RUNNER to true in any windows that it launches. This is useful for scripting outside of neovim. For example showing an indicator on your shell prompt when the window is a kitty-runner window.

Installation

With packer:

use {
  "lkemitchll/kitty-runner.nvim",
  config = function()
    require("kitty-runner").setup()
  end
}

Configuration

The setup function allows adjusting various settings. By default it sets the following:

require("kitty-runner").setup({
  -- name of the kitty terminal:
  runner_name = "kitty-runner-" .. uuid,
  -- kitty arguments when sending lines/command:
  run_cmd = { "send-text", "--match=title:" .. "kitty-runner-" .. uuid },
  -- kitty arguments when killing a runner:
  kill_cmd = { "close-window", "--match=title:" .. "kitty-runner-" .. uuid },
  -- use default keymaps:
  use_keymaps = true,
  -- the port used to communicate with the kitty terminal:
  kitty_port = "unix:/tmp/kitty",
  -- arguments used when spawning the runner window
  win_args = { "--keep-focus", "--cwd=" .. vim.fn.getcwd() },
  -- when true the runner will close when neovim does
  kill_on_quit = true,
})

About

A neovim plugin allowing you to easily send lines from the current buffer to another kitty terminal

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Lua 100.0%