kitty-scrollback.nvim
Open your Kitty terminal scrollback buffer in Neovim to search, copy, and execute commands.
What is kitty-scrollback.nvim?
kitty-scrollback.nvim is a Neovim plugin that integrates with the Kitty terminal emulator, allowing users to open their terminal scrollback history directly in Neovim. It enables powerful text manipulation, searching, copying, and command execution within the editor, enhancing terminal workflow efficiency by leveraging Neovim's editing capabilities.
Neovim users who work extensively in the Kitty terminal emulator and want to edit, search, and execute terminal output using their familiar editor environment. It is particularly useful for developers and system administrators who frequently need to review and manipulate command output.
Developers choose this plugin for its tight integration between Kitty and Neovim, providing a seamless way to use Neovim's advanced editing features on terminal scrollback. Its unique selling point is the ability to not only view but also edit and execute terminal commands directly from Neovim, offering a more powerful alternative to Kitty's built-in scrollback navigation.
Overview
😽 Open your Kitty scrollback buffer with Neovim. Ameowzing!
Use Cases
Best For
- Editing and re-executing complex shell commands from terminal history within Neovim
- Searching and copying specific output from long terminal scrollback buffers using Neovim's search capabilities
- Modifying multi-line command output before pasting it back into the terminal for execution
- Reviewing and analyzing command output with syntax highlighting and other Neovim editing features
- Integrating terminal workflow with existing Neovim plugins and configurations for a unified editing experience
- Editing shell command lines (bash, fish, zsh) in Neovim before execution for improved accuracy and efficiency
Not Ideal For
- Teams using terminal emulators other than Kitty, such as Alacritty or WezTerm, as it relies on Kitty-specific remote control features.
- Developers seeking a plug-and-play scrollback viewer without configuration, given the multi-step setup involving kitty.conf edits and Neovim plugin management.
- Environments where enabling terminal remote control poses security risks, as it requires allow_remote_control and listen_on settings in Kitty.
- Users locked into older versions of Neovim (<0.10) or Kitty (<0.43.0) who cannot upgrade, due to version-specific dependencies and breaking changes.
Pros & Cons
Pros
Directly accesses Kitty's scrollback buffer via remote control, enabling seamless opening and manipulation of terminal history within Neovim without context switching.
Leverages Neovim's full editing suite—like visual selection, search, and paste windows—to modify, copy, or execute terminal output before sending it back to Kitty.
Offers detailed Lua-based configuration for keymaps, highlights, and behavior, with support for global, builtin, and user-defined setups to tailor the experience.
Supports editing bash, fish, and zsh command lines in Neovim before execution, improving accuracy for complex commands, though it requires additional shell setup.
Cons
Exclusively designed for Kitty terminal emulator, rendering it useless for users of alternatives like iTerm2 or GNOME Terminal, limiting its portability.
Requires multiple non-trivial steps: editing kitty.conf, generating kitten mappings, and managing Neovim configuration, which can be error-prone for newcomers.
As highlighted in migration steps, the plugin drops support for older Kitty and Neovim versions, forcing upgrades and potentially disrupting workflows.
Command-line editing only works with bash, fish, and zsh (zsh requires v5.9+), excluding other shells and adding setup overhead for each supported shell.
Frequently Asked Questions
Related Projects
toggleterm.nvimA neovim lua plugin to help easily manage multiple terminal windows
neotermWrapper of some vim/neovim's :terminal functions.
FTerm.nvim:fire: No-nonsense floating terminal plugin for neovim :fire:
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.