Neovim

Overview

Neovim integrates with AgentZero via ACP (terminal/jobstart) or MCP (via plugins like mcp-hub.nvim).

Recommended: ACP — AgentZero runs the full agentic loop using your local models.

ACP Setup (Recommended)

Terminal split

The simplest approach: open a terminal split and run the interactive chat:

:vsplit | terminal az chat

Or start the ACP server for programmatic interaction:

:vsplit | terminal az serve

Single-shot queries

Use print mode for quick questions without an interactive session:

az chat -P "explain what this function does" --mode text

Lua integration

For deeper integration, spawn az serve as a job:

local job = vim.fn.jobstart({'az', 'serve'}, {
  on_stdout = function(_, data)
    -- Handle ACP JSON-RPC responses
  end,
  stdin = 'pipe',
})

-- Send a chat message
local request = vim.fn.json_encode({
  id = "1",
  method = "chat",
  params = { message = "fix the bug on line 42" }
})
vim.fn.chansend(job, request .. "\n")

MCP Setup

Use mcp-hub.nvim or similar MCP client plugins:

require('mcp-hub').setup({
  servers = {
    agentzero = {
      command = 'az',
      args = { 'mcp' },
    },
  },
})

Security

Stdio-only transport — no network ports opened
Policy enforcement on all tool calls
Audit trail in .agentzero/audit/

Troubleshooting

“command not found: az” — ensure az is in your PATH
Provider errors — run az doctor