Skip to content
Lazy Docs

Toggleterm

Toggleterm is a Neovim plugin that provides terminal integration with features like floating windows, multiple terminals, and custom commands.

What Problem Does It Solve?

Traditional terminal integration in Neovim can be:

  • Limited to basic terminal windows
  • Missing floating terminal support
  • No multiple terminal instances
  • Lacks customization options
  • Inefficient terminal management

How It Improves Productivity

  1. Better Interface:

    • Floating terminal windows
    • Multiple terminal instances
    • Terminal size customization
    • Direction control

  2. Enhanced Features:

    • Custom terminal commands
    • Auto-insert mode
    • Terminal buffer management
    • Performance optimization

  3. Advanced Features:

    • Custom commands
    • Terminal autocommands
    • Terminal highlights
    • Integration with other plugins

How to Use

Basic Usage

  • Toggle terminal with C-\
  • Toggle float with C-\C-\
  • Toggle horizontal with C-\C-h
  • Toggle vertical with C-\C-v
  • Toggle tab with C-\C-t
  • Toggle open with C-\C-o
  • Toggle close with C-\C-c
  • Toggle new with C-\C-n
  • Navigate with C-h/j/k/l
  • Move to window with C-w+h/j/k/l
  • Switch windows with C-w+w
  • Previous window with C-w+p
  • Close window with C-w+c
  • Close other windows with C-w+o

Configuration

  • Edit lua/config/toggleterm.lua
  • Set up custom terminals
  • Configure keybindings
  • Customize appearance

Integration

  • Works with git
  • Compatible with LSP
  • Supports custom commands
  • Works with other plugins