Skip to content

Changes by create-pull-request action #21

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
dasvh merged 1 commit into from
Jan 9, 2026
Merged

Changes by create-pull-request action #21

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 10 additions & 8 deletions doc/taskfile.nvim.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
*taskfile.nvim.txt* For Neovim >= 0.8.0 Last change: 2025 September 22
*taskfile.nvim.txt* For Neovim >= 0.8.0 Last change: 2026 January 09

==============================================================================
Table of Contents *taskfile.nvim-table-of-contents*
Expand All @@ -21,14 +21,14 @@ A simple plugin for taskfiles <https://taskfile.dev/>
FEATURES *taskfile.nvim-taskfile.nvim-features*

- Run a specific task directly within Neovim
- Browse available tasks with a floating window
- Browse available tasks with a floating window **or** Telescope <https://github.com/nvim-telescope/telescope.nvim>
- Preview each task’s command before execution
- Run tasks in a floating terminal
- Automatically scroll to bottom of output (optional)
- Rerun last task via command or key-map
- Flexible layouts:
- **Horizontal**task list and preview side-by-side
- **Vertical**task list stacked above preview
- **Horizontal**: task list and preview side-by-side
- **Vertical**: task list stacked above preview
- Configurable `width_ratio` / `height_ratio` or automatic sizing
to neatly fit task names and descriptions
- Toggle between horizontal and vertical layouts at runtime
Expand All @@ -38,6 +38,7 @@ REQUIREMENTS *taskfile.nvim-taskfile.nvim-requirements*

- task <https://taskfile.dev/#/installation> CLI installed and in your `$PATH`
- Neovim 0.8 or higher (0.9+ recommended)
- telescope.nvim <https://github.com/nvim-telescope/telescope.nvim> (optional, only if using `picker = "telescope"`)


SETUP *taskfile.nvim-taskfile.nvim-setup*
Expand All @@ -59,6 +60,7 @@ fields are optional and shown below with their default values:

>lua
require('taskfile').setup({
picker = "native", -- Selection UI: 'native' (default) or 'telescope'
layout = "horizontal", -- Layout: 'h', 'horiz', 'horizontal' or 'v', 'vert', 'vertical'.
-- For 'horizontal' layout, list and preview are side-by-side.
-- For 'vertical', list is above preview (vertically stacked).
Expand Down Expand Up @@ -102,10 +104,10 @@ This plugin reads your Taskfile and displays available tasks.

COMMANDS ~

- `:Task <task_name>`Run a specific task by name
- `:Task`Show a floating task selector with preview
- `:TaskRerun`Rerun the last executed task
- `:TaskToggleLayout`Toggles the layout for the current Neovim session.
- `:Task <task_name>`: Run a specific task by name
- `:Task`: Show a floating task selector with preview
- `:TaskRerun`: Rerun the last executed task
- `:TaskToggleLayout`: Toggles the layout for the current Neovim session.
On restart, it resets to your configured default.

You can also bind a key to rerun using the `keymaps.rerun` config.
Expand Down