Using Variables

Variables allow you to dynamically insert Neovim context into your chat messages using the #{variable_name} syntax. They're processed when you send your message to the LLM, automatically including relevant content like buffer contents, LSP diagnostics, or your current viewport. Type # in the chat buffer to see available variables through code completion, or type them manually.

Custom variables can be shared in the chat buffer by adding them to the strategies.chat.variables table in your configuration.

Basic Usage

Variables use the #{variable_name} syntax to dynamically insert content into your chat. For example #{buffer}. Variables are processed when you send your message to the LLM.

#buffer

IMPORTANT

By default, CodeCompanion automatically applies {diff} to all buffers

The #{buffer} variable shares buffer contents with the LLM. It has two special parameters which control how content is shared, or synced, with the LLM, on each turn:

{all} - Sends all of the buffer content to the LLM whenever the buffer changes. Use this when you want the LLM to always have the complete, up-to-date file context.

{diff} - Sends only the changed portions of the buffer to the LLM. Use this for large files where you only want to share incremental changes to reduce token usage.

Basic Usage

• #{buffer} - Shares the current buffer (last one you were in)

Target Specific Buffers

• #{buffer:init.lua} - Shares a specific file by name
• #{buffer:src/main.rs} - Shares a file by relative path
• #{buffer:utils} - Shares a file containing "utils" in the path

With Parameters

• #{buffer}{all} - Sends entire buffer on any change
• #{buffer}{diff} - Sends only changed portions of the buffer
• #{buffer:config.lua}{all} - Combines targeting with parameters

Multiple Buffers

Compare #{buffer:old_file.js} with #{buffer:new_file.js} and explain the differences.

Note: For selecting multiple buffers with more control, use the /buffer slash command.

#lsp

TIP

The Action Palette has a pre-built prompt which asks an LLM to explain LSP diagnostics in a visual selection

The lsp variable shares any information from the LSP servers that active in the current buffer. This can serve as useful context should you wish to troubleshoot any errors with an LLM.

#viewport

The viewport variable shares with the LLM, exactly what you see on your screen at the point a response is sent (excluding the chat buffer of course).