opencode.nvim

<div align="center">
  <img src="https://raw.githubusercontent.com/sudo-tee/opencode.nvim/docs-assets/opencode-nvim.png" alt="opencode.nvim logo" width="30%" />
</div>

# 🤖 opencode.nvim

A Neovim frontend for [OpenCode](https://opencode.ai). Chat with the agent in a
side panel, send it files, selections, and diagnostics, and review its edits
without leaving the editor.

---

<div align="center">

![Neovim](https://img.shields.io/badge/NeoVim-%2357A143.svg?&style=for-the-badge&logo=neovim&logoColor=white)
[![GitHub stars](https://img.shields.io/github/stars/sudo-tee/opencode.nvim?style=for-the-badge)](https://github.com/sudo-tee/opencode.nvim/stargazers)
![Last Commit](https://img.shields.io/github/last-commit/sudo-tee/opencode.nvim?style=for-the-badge)

<a href="https://www.buymeacoffee.com/sudo.tee"><img src="https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png" height="30px"></a>

</div>

<div align="center">

![OpenCode chat panel beside a code buffer](https://github.com/user-attachments/assets/42da57f3-86b6-4409-b612-12c31fb1873f)
</div>

## Features

- [Chat panel](docs/usage.md#move-between-code-and-conversation) with separate
  input and output buffers, [prompt history](docs/usage.md#prompt-history), and
  [Markdown rendering](docs/usage.md#markdown-rendering).
- [Context](docs/context.md) from the current file,
  [visual selections](docs/context.md#add-a-selection),
  [`@` file mentions](docs/context.md#mention-files-and-agents), diagnostics,
  and [clipboard images](docs/context.md#attach-an-image).
- [Multiple sessions](docs/usage.md#sessions-and-panel-tabs), each in its own
  panel tab, plus a session picker and
  [timeline](docs/usage.md#timeline-and-session-tree) with undo and fork.
- [Session diff review](docs/review.md) with
  [inline comments](docs/review.md#leave-inline-feedback) that go into your next
  prompt (OpenCode V2).
- [Quick chat](docs/quick-chat.md) for one-off edits on the
  current line or selection (experimental).

Works with OpenCode V1 and V2 servers; the protocol is detected automatically.
The `v1` branch keeps the old plugin code and is not needed for a V1 server.
See [Compatibility](docs/compatibility.md).

## Install

Requires Neovim 0.10.3 or later and the `opencode` CLI on your `PATH`, with a
provider already connected (run `opencode` and use `/connect`).

With [lazy.nvim](https://github.com/folke/lazy.nvim):

```lua
return {
  'sudo-tee/opencode.nvim',
  dependencies = {
    -- Optional: choose a picker you already use, or keep vim.ui.select.
    -- 'folke/snacks.nvim',
    -- 'nvim-telescope/telescope.nvim',
    -- 'ibhagwan/fzf-lua',
    -- 'nvim-mini/mini.pick',
    -- Optional: use your configured completion engine, or built-in completion.
    -- 'saghen/blink.cmp',
    -- 'hrsh7th/nvim-cmp',
    {
      'MeanderingProgrammer/render-markdown.nvim',
      opts = {
        anti_conceal = { enabled = false },
        file_types = { 'markdown', 'opencode_output' },
      },
      ft = { 'ma