Tasks ([tasks]) Layer

The [tasks] layer controls the task manager overlay, which displays ongoing file operations, plugin tasks, and shell processes.

Actions

Action	Arguments/Options	Description
show	—	Open the task manager overlay
close	—	Close the task manager
arrow	--up, --down	Navigate through the task list
inspect	—	View logs for the selected task

Inspect Logs

The inspect action opens the log viewer for a specific task. The log content depends on the task type:

Task Type	Log Content
I/O operations (copy, move, remove)	Per-file progress, errors, skipped files
Lua plugins	Lua error traces, print() output, ya.err() messages
Shell commands	stdout and stderr output from the spawned process

[tasks]
prepend_keymap = [
  { on = "i", run = "inspect", desc = "Inspect selected task" },
]

Task Management

Action	Arguments/Options	Description
cancel	—	Cancel the selected task
help	—	Open help menu for the tasks layer
plugin	args	Run a plugin from the tasks context
noop	—	No operation

Example Configuration

[tasks]
prepend_keymap = [
  { on = "q",     run = "close",    desc = "Close tasks" },
  { on = "<Esc>", run = "close",    desc = "Close tasks" },
  { on = "i",     run = "inspect",  desc = "Inspect task log" },
  { on = "d",     run = "cancel",   desc = "Cancel task" },
]
append_keymap = [
  { on = "j",  run = "arrow --down", desc = "Move down" },
  { on = "k",  run = "arrow --up",   desc = "Move up" },
  { on = "<C-d>", run = "arrow --down 5", desc = "Move down 5" },
  { on = "<C-u>", run = "arrow --up 5",   desc = "Move up 5" },
]

tip

Tasks that complete with errors remain visible in the task manager until dismissed. Use inspect to review what went wrong.