github github
star 33
alert-circle 0
open issues
users 1
git-branch 2



15 days ago

VS Tasks

Telescope plugin to load and run tasks in a project that conform to VS Code's Editor Tasks


  • ⚙ Run tasks with Toggleterm
    • run tasks in a horizontal or vertical split terminal
  • ✏️ edit input variables that will be used for the session
  • Use VS Code's variables in the command (limited support, see desired features)


Short Demo

Setup and usage

With Plug:

Plug 'nvim-lua/popup.nvim'
Plug 'nvim-lua/plenary.nvim'
Plug 'nvim-telescope/telescope.nvim' " make sure you have telescope installed
Plug 'EthanJWright/vs-tasks.nvim'

With Packer:

use {
  requires = {

Set up keybindings:

nnoremap <Leader>ta :lua require("telescope").extensions.vstask.tasks()<CR>
nnoremap <Leader>ti :lua require("telescope").extensions.vstask.inputs()<CR>
nnoremap <Leader>tt :lua require("telescope").extensions.vstask.close()<CR>

Note: When the task telescope is open:

  • Enter will open in toggleterm
  • Ctrl-v will open in a vertical split terminal
  • Ctrl-p will open in a split terminal


  • Configure harpoon use (auto cache terminals based on task)
  • Configure toggle term use
  • Configure terminal behavior
lua <<EOF
  use_harpoon = true, -- use harpoon to auto cache terminals
  telescope_keys = { -- change the telescope bindings used to launch tasks
      vertical = '<C-v>',
      split = '<C-p>',
      tab = '<C-t>',
      current = '<CR>',
  terminal = 'toggleterm',
  term_opts = {
    vertical = {
      direction = "vertical",
      size = "80"
    horizontal = {
      direction = "horizontal",
      size = "10"
    current = {
      direction = "float",
    tab = {
      direction = 'tab',



In your project root set up .vscode/tasks.json

  "version": "2.0.0",
  "tasks": [
    "label": "🧪 Run unit tests that match the expression",
    "type": "shell",
    "command": "pytest -k '${input:expression}'"
    "label": "🐮 Cowsay",
    "type": "shell",
    "command": "echo ${input:cowmsg} | cowsay"
  "inputs": [
    "id": "expression",
    "description": "Expression to filter tests with",
    "default": "",
    "type": "promptString"
    "id": "cowmsg",
    "description": "Message for cow to say",
    "default": "Hello there!",
    "type": "promptString"


lua require("telescope").extensions.vstask.tasks() -- open task list in telescope
lua require("telescope").extensions.vstask.inputs() -- open the input list, set new input
lua require("telescope").extensions.vstask.close() -- close the task runner (if toggleterm)

You can also configure themes and pass options to the picker

lua require("telescope").extensions.vstask.tasks(require('telescope.themes').get_dropdown()) -- open task list in telescope

Features to implement

Full VS Code variable support

All variables available in VS Code should also work in this plugin, though they are not all tested.

Extend support for VS Code schema

At this point only the features I need professionally have been implemented. The implemented schema elements are as follows:

  • Tasks: Label
  • Tasks: Command
  • Tasks: ID
  • Inputs: Description
  • Inputs: Default

As I do not use VS Code, the current implementation are the elements that seem most immediately useful. In the future it may be good to look into implementing other schema elements such as problemMatcher and group.