A task runner and job management plugin for Neovim
  • Lua 94.6%
  • Python 4.8%
  • Makefile 0.3%
  • Shell 0.2%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Ömer Fadıl USTA a93d9f6d6d
fix(go-task): support go-task binary for Arch Linux (#511)
On Arch Linux, the 'task' binary is renamed to 'go-task' to avoid
conflicts with Taskwarrior.

This change adds a check for the 'go-task' executable and uses it if
available. It also updates error messages and the task builder to
use the detected binary name dynamically.
2026-05-24 10:38:28 -07:00
.github ci: bump action versions 2026-05-24 02:55:36 -07:00
.vscode test: tweak some VSCode tasks for testing 2025-03-26 23:18:54 -07:00
doc [docgen] Update docs 2026-04-01 21:43:15 +00:00
lua fix(go-task): support go-task binary for Arch Linux (#511) 2026-05-24 10:38:28 -07:00
plugin feat: do not require calling setup() 2025-10-20 12:24:54 -07:00
scripts doc: add Task fields to API documentation 2025-10-20 12:24:55 -07:00
tests fix(pnpm): Revert "add support for glob pattern in npm workspaces and pnpm-workspaces.yaml" 2026-01-11 13:42:31 -08:00
.envrc ci: improve envrc setup 2025-01-04 21:39:07 -08:00
.gitignore ci: improve envrc setup 2025-01-04 21:39:07 -08:00
.gitmodules ci: refactor doc and ci scripts 2023-09-01 16:37:54 -07:00
.luacheckrc feat: squash history for alpha release 2022-07-21 21:33:57 -07:00
.luarc.json lint: stricter type checking 2024-09-17 08:13:59 -07:00
.stylua.toml format: auto sort requires 2023-10-08 23:37:34 -07:00
CHANGELOG.md chore(master): release 2.1.0 (#461) 2026-01-12 11:32:39 -08:00
justfile refactor!: get rid of shell template 2025-10-20 12:24:53 -07:00
LICENSE Initial commit 2022-05-17 17:03:58 -07:00
Makefile tools: improve makefile 2025-10-20 12:23:40 -07:00
README.md doc: add Task fields to API documentation 2025-10-20 12:24:55 -07:00
run_tests.sh ci: improve isolation of test running 2022-11-13 13:09:53 -08:00
selene.toml chore: add selene config for neovim std lib 2022-07-26 10:27:55 +02:00
vim.toml chore: add selene config for neovim std lib 2022-07-26 10:27:55 +02:00

overseer.nvim

A task runner and job management plugin for Neovim

Features

  • Built-in support for many task frameworks (make, npm, cargo, .vscode/tasks.json, etc)
  • Simple integration with vim.diagnostic and quickfix
  • UI for viewing and managing tasks
  • Quick controls for common actions (restart task, rerun on save, or user-defined functions)
  • Extreme customizability. Very easy to attach custom logic to tasks
  • Define and run complex multi-stage workflows
  • Support for preLaunchTask when used with nvim-dap

Requirements

Installation

overseer supports all the usual plugin managers

lazy.nvim
{
  'stevearc/overseer.nvim',
  ---@module 'overseer'
  ---@type overseer.SetupOpts
  opts = {},
}
Packer
require("packer").startup(function()
  use({
    "stevearc/overseer.nvim",
    config = function()
      require("overseer").setup()
    end,
  })
end)
Paq
require("paq")({
  { "stevearc/overseer.nvim" },
})
vim-plug
Plug 'stevearc/overseer.nvim'
dein
call dein#add('stevearc/overseer.nvim')
Pathogen
git clone --depth=1 https://github.com/stevearc/overseer.nvim.git ~/.vim/bundle/
Neovim native package
git clone --depth=1 https://github.com/stevearc/overseer.nvim.git \
  "${XDG_DATA_HOME:-$HOME/.local/share}"/nvim/site/pack/overseer/start/overseer.nvim

Quick start

Add the following to your init.lua

require("overseer").setup()

To get started, all you need to know is :OverseerRun to select and start a task, and :OverseerToggle to open the task list.

https://user-images.githubusercontent.com/506791/189036898-05edcd62-42e7-4bbb-ace2-746b7c8c567b.mp4

If you don't see any tasks from :OverseerRun, it might mean that your task runner is not yet supported. There is currently support for VS Code tasks, make, npm, cargo, and some others.

If you want to define custom tasks for your project, I'd recommend starting with the tutorials.

Tutorials

Guides

Explanation

Third-party integrations

Recipes

Reference

Screenshots

https://user-images.githubusercontent.com/506791/180620617-2b1bb0a8-5f39-4936-97c2-04c92f1e2974.mp4