sia.nvim

An LLM assistant for Neovim.

Supports: OpenAI, Codex, Copilot and OpenRouter (both OpenAI Chat Completions and Responses), Anthropic (native API), Gemini and ZAI.

Features

Screen.Recording.2025-10-08.at.21.30.32.mov

Screencast.from.2025-09-14.23-23-03.mp4

Screen.Recording.2024-10-11.at.15.42.20.mov

Screen.Recording.2025-09-16.at.15.49.16_compressed.mp4

• Multiple interaction modes — chat, insert, and diff for different workflows
• Comprehensive tool system — file operations, code search, shell access, LSP, and more
• Flexible approval system — blocking or async tool approval with customizable notifications
• Change review — inline diff with accept/reject for AI-suggested edits
• Agent system — custom autonomous agents for specialized tasks
• Project-level config — per-project models, permissions, and risk levels
• Persistent memory — agent memory
• Cost tracking — real-time token usage and cost monitoring

Requirements

• Neovim >= 0.11
• curl
• ripgrep (rg) — for the grep tool
• fd — for the glob tool and directory listing
• Access to OpenAI API, Codex, Copilot, Gemini, Anthropic, ZAI, or OpenRouter
• Optional: pandoc — for the fetch tool (web content conversion)

Installation

Install using Lazy:

{
  "isaksamsten/sia.nvim",
  opts = {},
  dependencies = {
    {
      "rickhowe/diffchar.vim",
      keys = {
        { "[z", "<Plug>JumpDiffCharPrevStart", desc = "Previous diff", silent = true },
        { "]z", "<Plug>JumpDiffCharNextStart", desc = "Next diff", silent = true },
        { "do", "<Plug>GetDiffCharPair", desc = "Obtain diff", silent = true },
        { "dp", "<Plug>PutDiffCharPair", desc = "Put diff", silent = true },
      },
    },
  },
}

Quick Start

1. Set up authentication for your provider.

2. Use :Sia to start a conversation:

   :Sia explain this codebase

3. Use :Sia! with a selection to get inline changes:

   :'<,'>Sia! refactor this function

Documentation

Document	Description
Getting Started	Installation, authentication, first commands
Modes	Chat, insert, and diff interaction modes
Commands	Command reference
Reviewing Changes	Inline diff workflow for accepting/rejecting edits
Keybindings	Suggested keybindings
Settings	Global settings and context management
Models	Model definitions, providers, pricing
Project Config	Per-project .sia/config.json reference
Confirmation	Blocking and async tool approval
Permission Rules	Allow/deny/ask rules and risk levels
Actions	Built-in and custom actions
Agents	Custom agents and memory
Skills	Reusable skill definitions
Tools	Available tools for the AI assistant
Reference	Highlight groups