Skip to content
AgentZero

Vim

Overview

Section titled “Overview”

Vim integrates with AgentZero via terminal splits running the ACP chat interface.

ACP Setup

Section titled “ACP Setup”

Terminal split

Section titled “Terminal split”

Open a vertical terminal split with the interactive chat:

:vertical terminal az chat

Single-shot queries

Section titled “Single-shot queries”

Use print mode for one-off questions:

Terminal window
az chat -P "explain this error" --mode text

Shell command integration

Section titled “Shell command integration”

Pipe content through AgentZero:

:!az chat -P "refactor this function" --mode text < %

Workflow Tips

Section titled “Workflow Tips”
  • Use :terminal az chat --stream for streaming responses
  • Use --model to switch models: az chat --model codellama
  • Use /tools in the chat session to see available tools
  • Use /tree to see conversation branching history

Security

Section titled “Security”
  • Stdio-only transport — no network ports opened
  • Policy enforcement on all tool calls
  • Audit trail in .agentzero/audit/

Troubleshooting

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