vimvim/vim/AGENTS.md

vim

AGENTS.md41k starsChanged 8 months agoVimView on GitHub

Guidance for AI coding agents working in the Vim repository. Vim is a text editor written in C. The canonical repository is https://github.com/vim/vim. The code is old and has grown…

We split this AGENTS.md into the rules it gives an agent

30 rules. About 0 are common, 19 are distinctive, and 11 are very specific to this project.

≈0
Common · estimate
Many files like this have a rule of this kind.
≈19
Distinctive · estimate
This author's own choices. Worth a look.
11
Very specific
Tied to their project's names, files or tools. Probably skip.

Licensed with conditions — read it at the source. We count its rules but don't quote them. Read them on GitHub.

≈ “Common” is an estimate: at least 1 in 5 of the 36,368 AGENTS.md files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Apr 15, 2024Vim Adds XDG_CONFIG_HOME Support5 points · 1 comment
Dec 22, 2022Vim cryptmethod is not authenticated (2016)5 points
Sep 30, 2019Colorschemes are wanted to be distributed with Vim5 points
Nov 21, 2017Interesting discussion: Vim PR rejected until author disclosed his/her real name5 points
Oct 29, 2018Vim Creator Asking for Feature Suggestions4 points
Jul 12, 2017Vim is getting a :terminal command4 points · 1 comment
Sep 13, 2016Vim 8.0 Release4 points · 2 comments
Feb 23, 2016Vim is adding native package support4 points
Oct 29, 2017Vim 8.0.1238 adds highlighting of all matches while incremental searching3 points · 1 comment
Feb 23, 2016Using Vim packages – Feb 21 20163 points
Dec 22, 2021Vim cryptmethod is not authenticated2 points
Dec 30, 2019Vim does not want to upgrade/remove “broken” crypto, don't use “-x”2 points
Jul 11, 2017Vim gets :terminal2 points
Jul 8, 2017Vim adds terminal emulator support2 points
Apr 13, 2016New features to be included in Vim 82 points
Sep 12, 2020Fuzzy string matching added to vim1 point
Aug 11, 2020The Vim documentation on gender-inclusive language1 point
Nov 21, 2018Vim command execution vulnerability1 point
Nov 2, 2018Bram Moolenaar: Support for (vim) plugin authors needs to be improved (poll)1 point
Oct 30, 2018Vim support for plugin authors needs to be improved (poll)1 point
Jun 9, 2017Vim: some people still don't know how to quit1 point
Feb 19, 2016Vim cryptmethod is not authenticated1 point

On Stack Overflow · 27

Mar 28, 2010How do I increase the spacing of the line number margin in vim?18 votes
Oct 1, 2019vim remove underline from line number17 votes
Jun 20, 2019Where to get MD5 hashes from a GitHub release?16 votes
Jul 10, 2016How does Vim guess background color on xterm?14 votes
Sep 8, 2015Gvim redraw issues with Virtual Box and Windows 7 host12 votes

22 more on Stack Overflow

Apr 6, 2018Why might weird characters ($p) appear at beginning of every file in vim?9 votes
Sep 18, 2016Vim double-indents python files9 votes
Jul 27, 2016Vim slow with ruby syntax highlighting8 votes
Jan 21, 2023NeoVim: Broken Syntax Highlighting after heredoc "lua << EOF" in VimScript7 votes
Feb 12, 2019How to determine a terminal's background color?7 votes
Oct 3, 2016Configure git commit editor colors7 votes
Jul 30, 2021How to copy from Vim to system clipboard using wayland and without compiled vim `+clipboard` feature flag5 votes
Dec 27, 2017In vim, why does c_ behave as if cc?5 votes
May 6, 2017Can't read when Vim/Neovim highlight same color as text5 votes
Aug 14, 2016How to set a transparent background for Vim with "true color" enabled?5 votes
Apr 26, 2016Does Vim have a character limit for regexes?5 votes
May 14, 2024How to copy from Vim to system clipboard using wayland and without compiled vim `+clipboard` feature flag4 votes
Sep 9, 2019Vim's Omnicompletion with Python just doesn't work4 votes
Jul 17, 2019How to implement complicated auto-indentation in VScode4 votes · 2 answers
May 2, 2019How can I make Vim paste from (and copy to) the system's clipboard?4 votes
Nov 9, 2017Why does gVim resize and reposition itself after some actions?4 votes
Apr 5, 2016Inverted colors in status line. Why?4 votes
Jan 13, 2016Disabling Vim command line feedback messages4 votes · 1 answer
Aug 20, 2023How can I figure out the meaning of a Vim error code?3 votes
Jun 24, 2020Format of marks in viminfo3 votes
Oct 9, 2018ld: warning: text-based stub file are out of sync. Falling back to library file for linking3 votes
Dec 4, 2015Get filename and line number that called vim autoload function3 votes

On YouTube · 15

Aug 8, 2023Vim: The Most Important Text Editor On Linux — Brodie Robertson32k views · 204 comments
Sep 27, 2023State Of Vim After Bram Moolenaar — Brodie Robertson31k views · 138 comments
Oct 25, 2022BEST Markdown Editors For Linux — The Linux Cast [Matthew Weber]18k views · 90 comments
Apr 5, 20225 Essential Linux Apps Everyone Should Use — The Linux Cast [Matthew Weber]9.4k views · 69 comments
Jan 17, 2022Bash Prompt Customization | Feat. Neovim — Programming Archive1.4k views · 2 comments

10 more on YouTube

Jun 1, 2025Primeiros passos com VIM — puts_dev395 views · 7 comments
Jul 10, 2025Enable clipboard on vim and neovim like a pro — mirra07368 views · 4 comments
Jan 2, 2022Bash Script to download Advent Of Code (AOC) Input | Feat. Neovim | Part 1 (reuploaded) — Programming Archive290 views
Jun 5, 2025How to install latest version of VIM on Ubuntu — MivoCloud187 views
Sep 4, 2026The code editor you may not have heard of — CodeRoom112 views
Jan 10, 2022Bash Script to download Advent Of Code (AOC) Input | Feat. Neovim | Part 2 — Programming Archive96 views
May 5, 2025The three kinds of Vim — LordWeegie50 views
Dec 23, 2024vim/vim #16284 ft=text — yanorei3226 views
Jan 4, 2022特定バージョンの vim の挙動がおかしい件 — Kazuya Jimba17 views
Dec 23, 2024vim/vim #16284 — yanorei3215 views · 2 comments

On GitHub · 4

Jul 5, 2022feat(window/ui): add splitkeep option — neovim/neovim137 reactions · 52 comments
Oct 12, 2022feat(ui): add 'statuscolumn' option — neovim/neovim44 reactions · 99 comments
Apr 26, 2023feat(ui): add 'smoothscroll' option — neovim/neovim42 reactions · 14 comments
Mar 25, 2018[RFC] support "virtual text" annotations (currently after EOL only) — neovim/neovim34 reactions · 31 comments

On Bluesky · 2

Sep 16, 2023📦 vim / vim ⭐ 32,702 (+33) 🗒 Vim Script The official Vim repository — @github-trending.bsky.social2 likes and reposts
Aug 7, 2023🚀 Skyrocketing！ 🚀 (200+ new stars) 📦 vim / vim ⭐ 31,381 (+308) 🗒 Vim Script The official Vim repository — @github-trending.bsky.social0 likes and reposts · 1 reply

Where files are headingNew AGENTS.md files have more rules about keeping secrets out of the code, and fewer about code style.
Of the AGENTS.md files we read, the 28,693 first seen in the last six months, against the older ones: the kind of rule that gained most share, and the kind that lost most. About files like this in general, not this one, and an estimate, since a kind is a pattern in the words.

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

It worked
Partly
It didn't

What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free

vim