{"id":16215578,"url":"https://github.com/dsieradzki/nvim-runner","last_synced_at":"2026-04-13T02:05:00.102Z","repository":{"id":230413021,"uuid":"777378500","full_name":"dsieradzki/nvim-runner","owner":"dsieradzki","description":"Generic task runner for Neovim","archived":false,"fork":false,"pushed_at":"2024-03-30T08:19:08.000Z","size":12,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-02-13T23:46:46.569Z","etag":null,"topics":["neovim","task-runner","vim"],"latest_commit_sha":null,"homepage":"","language":"Lua","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dsieradzki.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-03-25T18:33:43.000Z","updated_at":"2024-03-29T23:20:54.000Z","dependencies_parsed_at":"2024-12-21T13:41:14.132Z","dependency_job_id":"34e97d4a-bb5b-4da1-9d25-b4be996e98c1","html_url":"https://github.com/dsieradzki/nvim-runner","commit_stats":null,"previous_names":["dsieradzki/nvim-runner"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dsieradzki%2Fnvim-runner","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dsieradzki%2Fnvim-runner/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dsieradzki%2Fnvim-runner/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dsieradzki%2Fnvim-runner/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dsieradzki","download_url":"https://codeload.github.com/dsieradzki/nvim-runner/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247744127,"owners_count":20988778,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["neovim","task-runner","vim"],"created_at":"2024-10-10T11:15:23.693Z","updated_at":"2026-04-13T02:05:00.065Z","avatar_url":"https://github.com/dsieradzki.png","language":"Lua","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Introduction\nThis is experimental plugin for running generic tasks with definition saved in working directory. I have created this plugin to help create background processes during development like database, backend, frontend.\n\n# Installation\nlazy.nvim\n```lua\n  {\n    'dsieradzki/nvim-runner',\n    \n    dependencies = {\n      -- Only when telescope integration is enabled\n      'nvim-telescope/telescope.nvim', -- optional\n\n      -- Only when you want to use which-key in mappings in example below\n      'folke/which-key.nvim', -- optional\n    },\n    config = function()\n      require('runner').setup {\n        --true|false(default): When integration with telescope is enabled, buffer is not shown on buffer list, unless task finish with error, or keep output is enabled in task, then buffer is unhidden\n        telescope = true,\n      }\n\n      -- Example mappings, before apply check are not conflicting with your current mappints\n      require('which-key').register {\n        ['\u003cleader\u003em'] = { name = 'Task runner', _ = 'which_key_ignore' },\n      }\n      vim.keymap.set('n', '\u003cleader\u003emr', ':Telescope runner run_task\u003cCR\u003e', { desc = '[R]un task', silent = true })\n      vim.keymap.set('n', '\u003cleader\u003emg', ':Telescope runner run_group\u003cCR\u003e', { desc = 'Run [G]roup of tasks', silent = true })\n      vim.keymap.set('n', '\u003cleader\u003eml', ':Telescope runner list\u003cCR\u003e', { desc = '[L]ist running tasks', silent = true })\n      vim.keymap.set('n', '\u003cleader\u003ems', ':Telescope runner stop\u003cCR\u003e', { desc = '[S]op task', silent = true })\n      vim.keymap.set('n', '\u003cleader\u003emS', ':RunnerStopAll\u003cCR\u003e', { desc = '[S]op all tasks', silent = true })\n    end,\n  },\n```\n\n# Commands\n- RunnerRunGroup [group name]\n- RunnerRunTask [task name]\n- RunnerList\n- RunnerStop \u003ctask name\u003e\n- RunnerStopAll\n\n# Telescope (when telescope integration is enabed)\n- Telescope runner list\n- Telescope runner run_task\n- Telescope runner run_group\n- Telescope runner stop\n\n# Example: tasks.lua\n```lua\nreturn {\n\tdefault_group = \"dev\",\n\tdefault_task = \"backend\",\n\tgroups = {\n\t\t{\n\t\t\tname = \"dev\",\n\t\t\ttasks = { \"database\", \"backend\", \"frontend\" },\n\t\t},\n\t},\n\ttasks = {\n\t\t{\n\t\t\tname = \"database\",\n\t\t\texec = \"make dev.db\",\n\t\t\tkeep_output = false,\n\t\t},\n\t\t{\n\t\t\tname = \"backend\",\n\t\t\texec = \"cargo watch -x run\",\n\t\t\tworking_dir = \"server/web-api\",\n\t\t},\n\t\t{\n\t\t\tname = \"frontend\",\n\t\t\texec = \"pnpm run dev\",\n\t\t\tworking_dir = \"web\",\n\t\t},\n\t},\n}\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdsieradzki%2Fnvim-runner","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdsieradzki%2Fnvim-runner","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdsieradzki%2Fnvim-runner/lists"}