git404hub

what is neoagent fr?

tarruda/neoagent — explained in plain English

Analysis updated 2026-07-24

16LuaAudience · developerComplexity · 3/5Setup · moderate

tl;dr

A Neovim plugin that brings AI coding assistants and chat models directly into your editor, supporting providers like OpenAI, Anthropic, DeepSeek, and local models.

vibe map

mindmap
  root((repo))
    What it does
      Chat with AI models
      Coding assistance
      Manage conversations
    AI Providers
      OpenAI
      Anthropic
      DeepSeek
      Local models
    Interaction modes
      Neo coding mode
      Chat conversation mode
    Tech stack
      Lua
      Neovim
    Key features
      Streaming responses
      Branching conversations
      Customizable tools

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Chat with AI models like ChatGPT or Claude without leaving Neovim.

VIBE 2

Get AI coding help that can read files and run shell commands.

VIBE 3

Run a local AI model privately for coding assistance inside the editor.

VIBE 4

Save and branch conversations to track different work threads.

what's the stack?

LuaNeovim

how it stacks up fr

tarruda/neoagentbjarneo/omarchy-ochre-themefullband7/openwrt-theme-foxhound
Stars161616
LanguageLuaLuaLua
Setup difficultymoderateeasymoderate
Complexity3/51/53/5
Audiencedevelopergeneralops devops

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Requires Neovim and an API key or login credentials for an AI provider like OpenAI or Anthropic.

No license information was provided in the explanation, so the terms of use are unknown.

in plain english

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.

prompts (copy fr)

prompt 1
How do I install and configure the neoagent Neovim plugin to use my OpenAI API key?
prompt 2
Show me how to set up neoagent to run a local AI model in Neovim for private coding assistance.
prompt 3
How do I switch between Neo coding mode and Chat mode in the neoagent Neovim plugin?
prompt 4
How do I save, label, and branch conversations in neoagent to track different tasks?

Frequently asked questions

what is neoagent fr?

A Neovim plugin that brings AI coding assistants and chat models directly into your editor, supporting providers like OpenAI, Anthropic, DeepSeek, and local models.

What language is neoagent written in?

Mainly Lua. The stack also includes Lua, Neovim.

What license does neoagent use?

No license information was provided in the explanation, so the terms of use are unknown.

How hard is neoagent to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is neoagent for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.