tarruda/neoagent

Neoagent is a plugin for Neovim, a popular text editor used by programmers. It brings AI-powered language models and coding assistants directly into the editor environment. The project is described as a small, hackable toolkit that lets users chat with AI models, get help with coding tasks, and manage conversations without leaving their text editor. The plugin supports a wide range of AI providers. Users can connect to models from OpenAI, Anthropic, DeepSeek, and Z.AI, or run local models on their own machine. It also works with existing subscriptions like Claude Pro, Max, and ChatGPT Plus. Users can log in with a simple command, and the plugin stores their credentials securely, prompting for API keys through a masked input. Once configured, users pick a default model and set a keyboard shortcut to open the tool. Neoagent offers two main modes of interaction. The first, called Neo, is designed for coding tasks and comes with built-in tools for file operations and running shell commands. The second, called Chat, is for simpler, tool-free conversation. Both modes run in a floating window inside Neovim, with a separate area for the conversation transcript and another for typing input. Responses stream in as they are generated, showing the model's reasoning, tool usage, and status. The toolkit is built to be flexible and customizable. Programmers can assemble different components, such as models, tools, and sessions, as standard Lua values, giving them control over how the agent operates. It supports cancellable agent loops, retry handling, and context compaction. Conversations can be saved with branches and labels, making it easy to track different threads of work. The README provides clear setup instructions and configuration examples for multiple providers, though it notes that some subscription authentications may incur extra usage charges. The full documentation is available inside Neovim through its built-in help system.