# skywind3000/asyncrun.vim

:rocket: Run Async Shell Commands in Vim 8.0 / NeoVim and Output to the Quickfix Window !!

Repository: https://github.com/skywind3000/asyncrun.vim
Canonical: https://ross.abutalabs.com/products/asyncrunvim
Homepage: https://www.vim.org/scripts/script.php?script_id=5431
Language: Vim Script
License: MIT
License Family: permissive
Topics: asyncrun, vim, vim-plugin, neovim, asynchronous, build, make, vim8, neomake, dispatch, neovim-plugin, cmake, terminal, nvim, vim-plugins, neovim-plugins
Last push: 2025-11-20T16:56:16+00:00

## Health v2 (maintenance only)
Score: 49/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 53, release rhythm 16, longevity 100
- inputs: {"age_days": 3661, "days_push": 286, "days_rel": 527, "gap_med": 135, "n_releases_24m": 2}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1904, forks 117 (observed 2026-08-28T04:05:51.846378+00:00)

## What it is
A Vim/NeoVim plugin that runs shell commands asynchronously in the background using Vim 8 and NeoVim job APIs, streaming output to the quickfix window in real time. It is a single self-contained Vim Script file with customizable runners, command modifiers, and errorformat-based error matching.

## Use cases
- run shell commands asynchronously in vim without blocking the editor
- compile a file with gcc from vim and see errors in quickfix
- run make or cmake builds in the background while editing
- run tests asynchronously and jump to failures via errorformat
- replace vim's blocking ! command with non-blocking execution
- run commands in a tmux or floaterm window from vim
- get notified when a long-running background job finishes

## When to choose
- you use Vim 8+ or NeoVim and want async shell command execution with quickfix output
- you want a lightweight single-file plugin for background builds and test runs
- you want a foundation for task systems like asynctasks.vim

## When to avoid
- you use an editor other than Vim or NeoVim
- you prefer built-in NeoVim terminal jobs or dispatch.vim-style workflows
- you need a full task runner with project task definitions (use asynctasks.vim instead)

## Facets
- artifact type: plugin
- maturity: stable
- function: developer-tools, cli, workflow-automation
- domain: developer-tools, text-editors
- platform: windows, cross-platform
- tags: vim-plugin, neovim-plugin, async, quickfix, build-tool, shell-commands, terminal, automation, linux, macos

## Member repositories
- skywind3000/asyncrun.vim (main) score 49

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:51.846378+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:11:51.711282+00:00, confidence not recorded.
  - readme: https://github.com/skywind3000/asyncrun.vim (fetched 2026-08-28T04:05:51.846378+00:00, sha ff19bd097516)
  - homepage: https://www.vim.org/scripts/script.php?script_id=5431 (fetched 2026-08-29T10:50:50.835995+00:00, sha b96a856d17a7)
  - site_page: https://www.vim.org/about.php (fetched 2026-08-29T10:50:50.845614+00:00, sha 1bd2c1907ce5)
  - site_page: https://www.vim.org/docs.php (fetched 2026-08-29T10:50:50.847575+00:00, sha 438015e9e2e2)
  - site_page: http://www.vim.org/about.php (fetched 2026-08-29T10:50:50.849298+00:00, sha fbe78bde9535)
- Data as of 2026-08-30T08:39:29.467469+00:00.