Files
tiny-checktime.nvim/README.md
T
swaits 8f9208f0d0
CI / lint (push) Canceled after 0s
CI / test (push) Canceled after 0s
feat: initial release
2026-04-09 17:30:30 -06:00

47 lines
977 B
Markdown

# 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:
```lua
"https://github.com/swaits/tiny-checktime.nvim",
```
## Configuration
All options are optional. Call `setup()` only if you want to customize:
```lua
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](LICENSE)