llm.vim

A Vim plugin that provides an interface to the llm command-line tool for accessing Large Language Models.

Features

• Execute llm templates on visually selected text
• Tab completion for available templates
• Visual diff presentation of changes
• Accept or reject modifications interactively

Requirements

• Vim 8.0+ or Neovim
• llm tool

Installation

Using vim-plug

Plug 'path/to/llm.vim'

Using Vundle

Plugin 'path/to/llm.vim'

Manual Installation

Copy or symlink this directory to your ~/.vim/pack/<plugins>/start/ directory.

Usage

Basic Command

:[range]Llm <template> [<prompt>...]

• [range]: Optional line range (e.g., 1,10 or use visual mode). If omitted, uses the entire buffer.
• <template>: Name of an llm template (supports tab completion)
• <prompt>: Optional additional prompt text

Example Workflow

On Selected Text

1. Select text in visual mode (press v or V)
2. Execute the command:

   :'<,'>Llm summarize

or with an additional prompt:

   :'<,'>Llm summarize make it concise

On Entire Buffer

Simply run the command without a range:

   :Llm summarize

Reviewing Changes

1. A diff view opens showing:

   • Left pane: Original text
   • Right pane: Modified text from llm

2. Review the changes and either:

   • Type :LlmAcceptAll to apply all changes
   • Type dp on a hunk to accept that specific hunk
   • Type <Leader>q to discard and close

Tab Completion

The plugin provides tab completion for template names. After typing :Llm, press <Tab> to cycle through available templates.

To see available templates, run:

uv tool run llm templates list

Creating Templates

You can create custom templates for the llm tool. Refer to the llm documentation for details on creating templates.

Example:

llm --save fix-grammar "Fix grammar and spelling in the following text"

Commands

:Llm

Main command to execute llm on selected text.

Syntax:

:[range]Llm <template> [<prompt>...]

Examples:

:Llm summarize               " Process entire buffer
:1,10Llm summarize           " Process lines 1-10
:'<,'>Llm fix-grammar        " Process visual selection
:'<,'>Llm translate translate to Spanish

Diff View Commands

The following commands are available in the diff view buffer:

:LlmAcceptAll

Accept all changes and apply them to the original buffer.

Syntax:

:LlmAcceptAll

Keybinding: <Leader>a

:LlmAcceptHunk

Accept the current hunk (change under cursor) and push it to the original buffer.

Syntax:

:LlmAcceptHunk

Keybinding: dp

After accepting a hunk, use ]c to jump to the next hunk.

:LlmClose

Close the diff view without accepting any remaining changes.

Syntax:

:LlmClose

Keybinding: <Leader>q

Configuration

The plugin can be customized with the following options in your .vimrc or init.vim:

g:llm_command

Path or command to invoke the llm tool. Default: 'llm'

Example:

" Use a specific path to llm
let g:llm_command = '/usr/local/bin/llm'

" Use llm via uv tool run
let g:llm_command = 'uv tool run llm'

g:llm_diff_wrap

Enable line wrapping in diff view buffers. Default: 1 (enabled)

Example:

" Disable line wrap in diff views
let g:llm_diff_wrap = 0

" Enable line wrap in diff views (default)
let g:llm_diff_wrap = 1

Troubleshooting

Templates not showing in completion

Make sure the llm tool is properly installed:

uv tool install llm
# Or with pipx:
pipx install llm

Command fails with error

Check that llm is working correctly:

echo "test" | llm -t <template>

No diff showing

Ensure that the llm command produces output. Some templates may require specific parameters or model configuration.

License

This plugin is released into the public domain.