tiny-checktime.nvim/README.md

tiny-checktime.nvim

A tiny plugin for Neovim 0.12+ that checks for externally modified files when focus returns.

Zero config. ~12 lines of Lua.

Features

• Runs :checktime on focus gain and terminal events
• Pairs with autoread to auto-reload changed files
• Configurable trigger events
• Works out of the box — no setup call required

Requirements

• Neovim >= 0.12

Installation

Add to your vim.pack.add() call:

"https://github.com/swaits/tiny-checktime.nvim",

Configuration

All options are optional. Call setup() only if you want to customize:

require("tiny-checktime").setup({
  events = { "FocusGained", "TermClose", "TermLeave" },
})

How it works

When Neovim regains focus (switching back from another app or terminal pane), it runs :checktime to ask Neovim to check if any buffers were modified on disk. Combined with vim.opt.autoread = true, changed files reload automatically.

License

MIT