Keybindings

Avante.nvim provides comprehensive keybindings for all plugin actions. This guide covers all default keybindings and how to customize them.

Default Keybindings

Global Actions

Key Binding	Description	Mode
`<leader>aa`	Show/open sidebar	Normal
`<leader>an`	Start new chat	Normal
`<leader>at`	Toggle sidebar visibility	Normal
`<leader>ae`	Edit selected blocks	Visual
`<leader>ar`	Refresh sidebar	Normal
`<leader>af`	Switch sidebar focus	Normal
`<leader>aS`	Stop current AI request	Normal
`<leader>a?`	Select model	Normal
`<leader>ah`	Select chat history	Normal
`<leader>ad`	Toggle debug mode	Normal
`<leader>as`	Toggle suggestion display	Normal
`<leader>aC`	Toggle selection	Normal
`<leader>aR`	Toggle repomap	Normal
`<leader>az`	Enter Zen mode	Normal

Key Binding	Description	Mode
`]p`	Next prompt	Normal
`[p`	Previous prompt	Normal
`A`	Apply all changes	Normal
`a`	Apply change at cursor	Normal
`r`	Retry user request	Normal
`e`	Edit user request	Normal
`<Tab>`	Switch windows	Normal
`<S-Tab>`	Reverse switch windows / Expand tool use	Normal
`x`	Toggle code window	Normal
`d`	Remove file	Normal
`@`	Add file	Normal
`q`	Close sidebar	Normal

File Management

Key Binding	Description	Mode
`<leader>ac`	Add current buffer to selected files	Normal
`<leader>aB`	Add all buffer files to selected files	Normal

Suggestion Actions

Key Binding	Description	Mode
`<M-l>`	Accept suggestion	Insert
`<M-]>`	Next suggestion	Insert
`<M-[>`	Previous suggestion	Insert
`<C-]>`	Dismiss suggestion	Insert

Key Binding	Description	Mode
`co`	Choose ours	Normal
`ct`	Choose theirs	Normal
`ca`	Choose all theirs	Normal
`cb`	Choose both	Normal
`cc`	Choose cursor	Normal
`]x`	Move to next conflict	Normal
`[x`	Move to previous conflict	Normal

Jump Actions

Key Binding	Description	Mode
`]]`	Jump to next	Normal
`[[`	Jump to previous	Normal

Submit/Cancel Actions

Key Binding	Description	Mode
`<CR>`	Submit (normal mode)	Normal
`<C-s>`	Submit (insert mode)	Insert
`<C-c>`, `<Esc>`, `q`	Cancel (normal mode)	Normal
`<C-c>`	Cancel (insert mode)	Insert

Confirm Window Actions

Key Binding	Description	Mode
`<C-w>f`	Focus confirm window	Normal
`c`	Confirm code	Normal
`r`	Confirm response	Normal
`i`	Confirm input	Normal

Customizing Keybindings

All keybindings can be customized through the mappings configuration:

require('avante').setup({
  mappings = {
    ask = "<leader>aa",
    new_ask = "<leader>an",
    zen_mode = "<leader>az",
    edit = "<leader>ae",
    refresh = "<leader>ar",
    focus = "<leader>af",
    stop = "<leader>aS",
    
    toggle = {
      default = "<leader>at",
      debug = "<leader>ad",
      selection = "<leader>aC",
      suggestion = "<leader>as",
      repomap = "<leader>aR",
    },
    
    sidebar = {
      expand_tool_use = "<S-Tab>",
      next_prompt = "]p",
      prev_prompt = "[p",
      apply_all = "A",
      apply_cursor = "a",
      retry_user_request = "r",
      edit_user_request = "e",
      switch_windows = "<Tab>",
      reverse_switch_windows = "<S-Tab>",
      toggle_code_window = "x",
      remove_file = "d",
      add_file = "@",
      close = { "q" },
      close_from_input = nil, -- e.g., { normal = "<Esc>", insert = "<C-d>" }
      toggle_code_window_from_input = nil, -- e.g., { normal = "x", insert = "<C-;>" }
    },
    
    files = {
      add_current = "<leader>ac",
      add_all_buffers = "<leader>aB",
    },
    
    select_model = "<leader>a?",
    select_history = "<leader>ah",
    
    diff = {
      ours = "co",
      theirs = "ct",
      all_theirs = "ca",
      both = "cb",
      cursor = "cc",
      next = "]x",
      prev = "[x",
    },
    
    suggestion = {
      accept = "<M-l>",
      next = "<M-]>",
      prev = "<M-[>",
      dismiss = "<C-]>",
    },
    
    jump = {
      next = "]]",
      prev = "[[",
    },
    
    submit = {
      normal = "<CR>",
      insert = "<C-s>",
    },
    
    cancel = {
      normal = { "<C-c>", "<Esc>", "q" },
      insert = { "<C-c>" },
    },
    
    confirm = {
      focus_window = "<C-w>f",
      code = "c",
      resp = "r",
      input = "i",
    },
  },
})

Safe Keymap Setting

Avante.nvim uses safe keymap setting by default. If a keybinding is already in use, Avante will not override it.

To disable auto-setting of keymaps:

behaviour = {
  auto_set_keymaps = false,
}

When auto_set_keymaps = false, you’ll need to manually set all keybindings.

Manual Keybinding Setup

If you disable automatic keymaps, set them manually:

local avante = require('avante')
local api = require('avante.api')

vim.keymap.set('n', '<leader>aa', api.ask, { desc = 'avante: ask' })
vim.keymap.set('n', '<leader>an', api.new_ask, { desc = 'avante: new ask' })
vim.keymap.set('n', '<leader>at', api.toggle, { desc = 'avante: toggle' })
vim.keymap.set('v', '<leader>ae', api.edit, { desc = 'avante: edit' })
vim.keymap.set('n', '<leader>ar', api.refresh, { desc = 'avante: refresh' })
vim.keymap.set('n', '<leader>af', api.focus, { desc = 'avante: focus' })

Some keybindings are only active when the sidebar is open:

sidebar.close_from_input

table | nil

Close sidebar from input window:

close_from_input = {
  normal = "<Esc>",
  insert = "<C-d>"
}

sidebar.toggle_code_window_from_input

table | nil

Toggle code window from input:

toggle_code_window_from_input = {
  normal = "x",
  insert = "<C-;>"
}

Conflict Mapping Customization

Customize diff conflict resolution mappings:

mappings = {
  diff = {
    ours = "co",      -- Choose our changes
    theirs = "ct",    -- Choose their changes
    all_theirs = "ca", -- Choose all their changes
    both = "cb",      -- Choose both changes
    cursor = "cc",    -- Choose change at cursor
    next = "]x",      -- Jump to next conflict
    prev = "[x",      -- Jump to previous conflict
  },
}

Timeout Override

Avoid operator-pending mode issues with diff mappings:

diff = {
  override_timeoutlen = 500, -- milliseconds, -1 to disable
}

Prompt Logger Keybindings

Navigate through prompt logs:

prompt_logger = {
  enabled = true,
  next_prompt = {
    normal = "<C-n>",
    insert = "<C-n>",
  },
  prev_prompt = {
    normal = "<C-p>",
    insert = "<C-p>",
  },
}

Example: Vim-Style Keybindings

Use Vim-style hjkl for navigation:

mappings = {
  sidebar = {
    switch_windows = "<C-j>",
    reverse_switch_windows = "<C-k>",
  },
  
  jump = {
    next = "<C-j>",
    prev = "<C-k>",
  },
  
  diff = {
    next = "<C-j>",
    prev = "<C-k>",
  },
}

Example: Minimal Keybindings

Minimal setup with only essential keybindings:

mappings = {
  ask = "<leader>a",
  toggle = {
    default = "<leader>A",
  },
  sidebar = {
    apply_all = "A",
    close = { "q", "<Esc>" },
  },
}

Integration with Other Plugins

NvimTree Integration

Add files from NvimTree to Avante:

require('neo-tree').setup({
  filesystem = {
    window = {
      mappings = {
        ['oa'] = 'avante_add_files',
      },
    },
    commands = {
      avante_add_files = function(state)
        local node = state.tree:get_node()
        local filepath = node:get_id()
        local relative_path = require('avante.utils').relative_path(filepath)
        
        local sidebar = require('avante').get()
        local open = sidebar:is_open()
        
        if not open then
          require('avante.api').ask()
          sidebar = require('avante').get()
        end
        
        sidebar.file_selector:add_selected_file(relative_path)
        
        if not open then
          sidebar.file_selector:remove_selected_file('neo-tree filesystem [1]')
        end
      end,
    },
  },
})

Commands vs Keybindings

All keybindings have corresponding commands:

Keybinding	Command	Description
`<leader>aa`	`:AvanteAsk`	Open sidebar
`<leader>an`	`:AvanteChatNew`	New chat
`<leader>at`	`:AvanteToggle`	Toggle sidebar
`<leader>ae`	`:AvanteEdit`	Edit selection
`<leader>ar`	`:AvanteRefresh`	Refresh
`<leader>af`	`:AvanteFocus`	Focus sidebar
`<leader>aS`	`:AvanteStop`	Stop request
`<leader>a?`	`:AvanteSwitchProvider`	Switch provider
`<leader>ah`	`:AvanteHistory`	Chat history

Use commands directly if you prefer:

:AvanteAsk What does this code do?
:AvanteEdit Refactor this function

Tips

Use :verbose map <leader>aa to check if a keybinding is already in use before setting it.

The ask, new_ask, and other top-level mappings are only set if behaviour.auto_set_keymaps = true.

Sidebar-specific mappings (like apply_all, retry_user_request) are always active when the sidebar is focused.

Get Started

Core Concepts

Configuration

Features

Providers

Advanced

Guides

Default Keybindings

Global Actions

Sidebar Actions

File Management

Suggestion Actions

Diff Navigation

Jump Actions

Submit/Cancel Actions

Confirm Window Actions

Customizing Keybindings

Safe Keymap Setting

Manual Keybinding Setup

Sidebar-Specific Keybindings

Conflict Mapping Customization

Timeout Override

Prompt Logger Keybindings

Example: Vim-Style Keybindings

Example: Minimal Keybindings

Integration with Other Plugins

NvimTree Integration

Commands vs Keybindings

Tips

Build docs developers (and LLMs) love

Get Started

Core Concepts

Configuration

Features

Providers

Advanced

Guides

​Default Keybindings

​Global Actions

​Sidebar Actions

​File Management

​Suggestion Actions

​Diff Navigation

​Jump Actions

​Submit/Cancel Actions

​Confirm Window Actions

​Customizing Keybindings

​Safe Keymap Setting

​Manual Keybinding Setup

​Sidebar-Specific Keybindings

​Conflict Mapping Customization

​Timeout Override

​Prompt Logger Keybindings

​Example: Vim-Style Keybindings

​Example: Minimal Keybindings

​Integration with Other Plugins

​NvimTree Integration

​Commands vs Keybindings

​Tips

Build docs developers (and LLMs) love

Default Keybindings

Global Actions

Sidebar Actions

File Management

Suggestion Actions

Diff Navigation

Jump Actions

Submit/Cancel Actions

Confirm Window Actions

Customizing Keybindings

Safe Keymap Setting

Manual Keybinding Setup

Sidebar-Specific Keybindings

Conflict Mapping Customization

Timeout Override

Prompt Logger Keybindings

Example: Vim-Style Keybindings

Example: Minimal Keybindings

Integration with Other Plugins

NvimTree Integration

Commands vs Keybindings

Tips