*opencode.nvim.txt*        Toggle opencode in a Neovim terminal

===============================================================================
CONTENTS                                             *opencode.nvim-contents*

1. Introduction                                      |opencode.nvim|
2. Requirements                                      |opencode.nvim-requirements|
3. Installation                                      |opencode.nvim-installation|
4. Usage                                             |opencode.nvim-usage|
5. Configuration                                     |opencode.nvim-configuration|
6. License                                           |opencode.nvim-license|

===============================================================================
INTRODUCTION                                           *opencode.nvim*

opencode.nvim toggles an `opencode` terminal in a configurable split.

The terminal buffer is hidden instead of deleted when closed, so the same
`opencode` session is shown the next time the window is toggled open.

===============================================================================
REQUIREMENTS                              *opencode.nvim-requirements*

- Neovim 0.10 or newer
- The `opencode` CLI installed and available on $PATH

This plugin does not install or bundle `opencode`; it only starts the CLI in a
Neovim terminal. Use of `opencode` is subject to that project's own license and
terms.

===============================================================================
INSTALLATION                              *opencode.nvim-installation*

Install with your plugin manager of choice.

Using lazy.nvim: >lua
  {
    "agj/opencode.nvim",
    opts = {
      width = 0.3,
      location = "right",
    },
  }
<

Using vim-plug: >vim
  Plug 'agj/opencode.nvim'
<

Then call setup from your Neovim configuration: >lua
  require("opencode").setup()
<

===============================================================================
USAGE                                          *opencode.nvim-usage*

                                                *:OpenCodeToggle*
:OpenCodeToggle
        Toggle the opencode terminal window.

        If the terminal window is visible, this closes only the window. The
        terminal buffer and running `opencode` process remain alive. If the
        terminal buffer already exists, the command reuses it.

===============================================================================
CONFIGURATION                          *opencode.nvim-configuration*

Call setup with an optional table: >lua
  require("opencode").setup({
    width = 0.3,
    location = "right",
  })
<

Options:                                             *opencode.nvim-options*

                                                        *opencode.nvim-width*
width                                                   number, default: 0.3
        Fraction of the screen width used by the terminal split for left and
        right locations, or the screen height for top and bottom locations.
        Must be greater than 0 and less than or equal to 1.

                                                     *opencode.nvim-location*
location                                                string, default: "right"
        Side of the screen where the terminal split opens. Must be one of
        "left", "right", "top", or "bottom".

===============================================================================
LICENSE                                      *opencode.nvim-license*

opencode.nvim is free software released under the GNU General Public License,
version 3 only. See the LICENSE file for the full license text.

This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE.

opencode.nvim is an independent Neovim plugin and is not affiliated with,
endorsed by, or sponsored by the maintainers of `opencode` or Neovim.

vim:tw=78:ts=8:noet:ft=help:norl:
