How do I set up key mappings for Executor.nvim in Neovim?

Executor.nvim does not provide default key mappings; you must manually bind keys using Vim commands or Lua API, as shown in the README with examples like vim.api.nvim_set_keymap for :ExecutorRun.

Executor.nvim vs vim-test for running tests in Neovim?

Executor.nvim is more general-purpose and configurable for any shell command with async execution, while vim-test is specifically tailored for test runners with built-in adapters. Choose Executor.nvim if you need flexibility beyond testing.

Can Executor.nvim run multiple commands simultaneously?

No, Executor.nvim focuses on running one task at a time per instance; it does not support parallel execution or task queues, which may limit complex workflow automation.

How to filter output to remove noise from command results?

Use the output_filter configuration function to programmatically modify lines before display, as detailed in the filtering output section, allowing custom logic like removing debug lines.

Does Executor.nvim save my command presets between projects?

Yes, command presets are configured via Lua and persist based on directory matching, but they rely on manual setup in your Neovim config rather than automatic project detection.

How do I switch between split and popup views temporarily?

Use commands like :ExecutorSwapToSplit or :ExecutorSwapToPopup to toggle views on the fly, useful for adapting to different task needs without reconfiguring settings.

executor.nvim — Neovim Background Task Runner

What is executor.nvim?

Executor.nvim is a Neovim plugin that enables asynchronous execution of command-line tasks directly within the editor. It is primarily designed for running tests but can handle any shell command, providing real-time notifications and flexible output viewing in splits or popup windows to streamline development workflows.

Target Audience

Neovim users, particularly developers who frequently run tests, build scripts, or other shell commands as part of their coding workflow and want to manage these tasks without leaving the editor.

Value Proposition

Developers choose Executor.nvim for its non-intrusive, configurable approach to background task management, offering features like command presets, output filtering, and status line integration that reduce context switching and enhance productivity within Neovim.

Overview

Executor.nvim is a Neovim plugin that enables users to execute command-line tasks asynchronously in the background, primarily designed for running tests but adaptable to any shell command. It provides real-time notifications upon task completion and flexible output viewing in splits or popup windows, streamlining development workflows directly within the editor.

Key Features

Background Task Execution — Runs commands asynchronously without blocking the editor interface.
Flexible Output Display — View results in a split window or a configurable popup.
Command Management — Store, recall, and modify frequently used commands with presets and history.
Notifications — Receive popup alerts when tasks start and finish, with success/failure indicators.
Status Line Integration — Display task status directly in the status line for quick visibility.
Output Filtering — Customize output by filtering lines programmatically before display.
Placeholder Support — Use $E_FN to reference the current buffer's filename in commands.

Philosophy

Executor.nvim emphasizes a non-intrusive, configurable approach to task management, allowing users to maintain focus while monitoring background processes with minimal disruption.

executor.nvim

What is executor.nvim?

Overview

Key Features

Philosophy

Related Projects

Found a gem we're missing?

Use Cases

Best For

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions