*vim-ai.txt*  Complete text using OpenAI API.

Author:  Martin Bielik <https://madox2.poriadne.sk/>
License: see https://github.com/madox2/vim-ai/blob/main/LICENSE

INTRODUCTION                                    *vim-ai*

This plugin can be used to generate code, edit text, brainstorm ideas,
translate, etc.

COMMANDS                                        *vim-ai-commands*

To set-up key bindings and expamples see:
https://github.com/madox2/vim-ai

                                                *:AI*

:AI                                 complete the text on the current line
:AI {prompt}                        complete the prompt
(selection) :AI                     complete the selection
(selection) :AI {instruction}       complete the selection using the instruction

Options: >
  let g:vim_ai_complete = {
  \  "options": {
  \    "model": "text-davinci-003",
  \    "max_tokens": 1000,
  \    "temperature": 0.1,
  \    "request_timeout": 10,
  \  },
  \}

Check OpenAI docs for more infomration:
https://platform.openai.com/docs/api-reference/completions

                                                *:AIEdit*

(selection)? :AIEdit                edit the current line or the selection
(selection)? :AIEdit {instruction}  edit the current line or the selection using
                                    the instruction

Options: >
  let g:vim_ai_edit = {
  \  "options": {
  \    "model": "text-davinci-003",
  \    "max_tokens": 1000,
  \    "temperature": 0.1,
  \    "request_timeout": 10,
  \  },
  \}

Check OpenAI docs for more infomration:
https://platform.openai.com/docs/api-reference/completions

                                                *:AIChat*


:AIChat                             continue or start a new conversation.
(selection)? :AIChat {instruction}? start a new conversation given the selection,
                                    the instruction or both

Options: >
  let g:vim_ai_chat = {
  \  "options": {
  \    "model": "gpt-3.5-turbo",
  \    "max_tokens": 1000,
  \    "temperature": 1,
  \    "request_timeout": 10,
  \  },
  \}

Check OpenAI docs for more infomration:
https://platform.openai.com/docs/api-reference/chat

CONFIGURATION                                   *vim-ai-config*

To customize the default configuration, initialize the config variable with
a selection of options: >

  let g:vim_ai_chat = {
  \  "options": {
  \    "model": "gpt-4",
  \    "temperature": 0.2,
  \  },
  \}

KEY BINDINGS

Examples how configure key bindins and customize commands: >

  " complete text on the current line or in visual selection
  nnoremap <leader>a :AI<CR>
  xnoremap <leader>a :AI<CR>

  " edit text with custom context
  xnoremap <leader>s :AIEdit fix grammar and spelling<CR>
  nnoremap <leader>s :AIEdit fix grammar and spelling<CR>

  " trigger chat
  xnoremap <leader>c :AIChat<CR>
  nnoremap <leader>c :AIChat<CR>

  " command with custom context (vim-ai functions: AIRun, AIEditRun, AIChatRun)
  command! -range -nargs=? AICode <line1>,<line2>call AIRun(<range>, "Programming syntax is " . &filetype . ", " . <f-args>)

ABOUT                                           *vim-ai-about*

Contributions are welcome on GitHub:

https://github.com/madox2/vim-ai