Aibo AI 工作流

Requirements

• Neovim 0.10.0 or later
• An AI assistant CLI tool (claude, codex, ollama, etc.) or any other interactive CLI tool

Installation

Use your preferred plugin manager.

Basic Setup

require('aibo').setup({
  submit_delay = 500,         -- Delay in milliseconds (default: 500)
  submit_key = '<CR>',        -- Key to send after submit (default: '<CR>')
  prompt_height = 10,         -- Prompt window height (default: 10)
  prompt_blend_insert = 10,   -- Prompt transparency in Insert mode 0-100 (default: 10)
  prompt_blend_normal = 30,   -- Prompt transparency in Normal mode 0-100 (default: 30)
  -- prompt_blend = 20,       -- DEPRECATED: Use prompt_blend_insert/normal instead
  termcode_mode = 'hybrid',   -- Terminal escape sequence mode: 'hybrid', 'xterm', or 'csi-n' (default: 'hybrid')
  disable_startinsert_on_startup = false, -- Disable auto insert in prompt window when first opened (default: false)
  disable_startinsert_on_insert = false,  -- Disable auto insert in prompt when entering insert from console (default: false)
})

Tool-Specific Setup

Configure tool-specific behavior through setup:

require('aibo').setup({
  tools = {
    claude = {
      no_default_mappings = true,  -- Disable Claude-specific defaults
      on_attach = function(bufnr, info)
        local opts = { buffer = bufnr, nowait = true, silent = true }
        -- Set your own Claude-specific mappings using <Plug>(aibo-send) pattern
        vim.keymap.set({ 'n', 'i' }, '<leader>a', '<Plug>(aibo-send)<Tab>', opts)
        vim.keymap.set({ 'n', 'i' }, '<leader>m', '<Plug>(aibo-send)<S-Tab>', opts)
        vim.keymap.set({ 'n', 'i' }, '<leader>v', '<Plug>(aibo-send)<C-o>', opts)
      end,
    },
  },
})

Usage

Examples

" AI assistants with specialized support and smart completions
:Aibo claude
:Aibo claude --continue
:Aibo claude --model sonnet
:Aibo claude --permission-mode plan
:Aibo codex
:Aibo codex --model claude-3.5-sonnet
:Aibo codex resume --last
:Aibo ollama run llama3
:Aibo ollama run qwen3:latest --verbose
:Aibo gemini

" Also works with any interactive CLI tool
:Aibo python -i                 " Python REPL
:Aibo node --interactive        " Node.js REPL
:Aibo psql mydatabase          " PostgreSQL client
:Aibo sqlite3 data.db          " SQLite client
:Aibo my-custom-cli-tool       " Your custom tool

[!NOTE] All Aibo commands support quoted strings for options with spaces. - Double quotes (") interpret escape sequences: -prefix="Line 1\nLine 2" - Single quotes (') treat everything literally: -prefix='Literal\n' - Example: -opener="botright split" or -prefix='Question: '

[!WARNING] Key mapping difference: To prevent unintended interrupts from the Vimmer's habit of hitting <Esc> repeatedly, <Esc> is NOT mapped in Aibo buffers. Instead: - Use <C-c> to send <Esc> to the AI tool (works in both normal and insert mode) - Use g<C-c> to send the interrupt signal (original <C-c> behavior, normal mode only)

Type in the prompt buffer and press <CR> in normal mode to submit. The prompt clears automatically for the next message. You can also use <C-Enter> or <F5> to submit even while in insert mode, which is particularly useful for continuous typing.

[!TIP] When focused on the console window, entering insert mode automatically opens the prompt window for input. This provides a seamless workflow - just press i in the console to start typing your next message.

To close the session, use :bdelete! or :bwipeout! on the console buffer.

Window Control Options

" Open with custom window command
:Aibo -opener=vsplit claude
:Aibo -opener="botright split" claude

" Stay in current window after opening
:Aibo -stay claude

" Toggle visibility of existing console
:Aibo -toggle claude

" Focus on existing console or open new one
:Aibo -focus claude

[!TIP] While Aibo provides predefined -opener completions, you can use any valid Vim window command. To dynamically size windows based on your terminal dimensions, use Neovim's <C-r>= expression register:

> :Aibo -opener="<C-r>=&columns * 2 / 3<CR>vsplit" claude
> 

For better usability, we recommend defining custom commands or mappings:

> -- Custom command for Claude with proportional window
> vim.api.nvim_create_user_command('Claude', function(opts)
>   local width = math.floor(vim.o.columns * 2 / 3)
>   vim.cmd(string.format('Aibo -opener="%dvsplit" claude %s', width, opts.args))
> end, { nargs = '*' })
> 

> -- Key mapping for quick access with dynamic sizing
> vim.keymap.set('n', '<leader>ai', function()
>   local width = math.floor(vim.o.columns * 2 / 3)
>   vim.cmd(string.format('Aibo -opener="%dvsplit" claude', width))
> end, { desc = 'Open Claude AI assistant' })
> 

Configuration

Advanced Configuration

The plugin works without any configuration, but you can customize it using setup(). The setup function can be called multiple times to update configuration:

require('aibo').setup({
  -- Prompt buffer configuration
  prompt = {
    no_default_mappings = false,  -- Set to true to disable default keymaps
    on_attach = function(bufnr, info)
      -- Custom setup for prompt buffers
      -- Runs AFTER ftplugin files
      -- info.type = "prompt"
      -- info.tool = tool name (e.g., "claude")
      -- info.aibo = aibo instance
    end,
  },

  -- Console buffer configuration
  console = {
    no_default_mappings = false,
    on_attach = function(bufnr, info)
      -- Custom setup for console buffers
      -- info.type = "console"
      -- info.cmd = command being executed
      -- info.args = command arguments
      -- info.job_id = terminal job ID
    end,
  },

  -- Tool-specific overrides
  tools = {
    claude = {
      no_default_mappings = false,
      on_attach = function(bufnr, info)
        -- Custom setup for Claude buffers
        -- Called after prompt/console on_attach
      end,
    },
    codex = {
      -- Codex-specific configuration
    },
  },
})

Callback Order

When both buffer type and tool-specific on_attach callbacks are defined, both are called in this order:

1. Buffer type on_attach (e.g., prompt.on_attach)
2. Tool-specific on_attach (e.g., tools.claude.on_attach)