NORMAL ~/wkd/p/tasks :set skin=modern utf-8

tasks.nvim

Open work as one Markdown file per task, with a few lines of flat YAML frontmatter, and a generated overview per project. The engine reads, ranks, indexes, creates, changes, finishes and checks those files; on top sit the :Tasks command with a dashboard, a form and a browser preview, and a headless CLI for scripts, CI and AI sessions that run without an editor. Nothing is stored anywhere but in the files.

status
alpha — Alpha, not released yet. The engine, the :Tasks command, the dashboard, the form and the headless CLI are built and covered by specs (72 spec files). Developed and tested on Windows; the CI runs the pipeline on Windows (pushes to main) and on Linux and Windows (pull requests). Pin a commit if you depend on this.
category
Project & repos
neovim
0.11+
repo
github.com/WKDSteve/tasks.nvim
commits
459
help
:help tasks

install

{
  "WKDSteve/tasks.nvim",
  opts = {},
}

also as

  • native app: tasks-desktop — A local web UI and desktop app for tasks.nvim
  • web: tasks-web — The page of tasks-desktop as a single HTML file that Chrome opens from disk (file://).

docs/

git log

  1. test mcp: scripts/mcp.lua as a real stdio process, driven by the lib.nvim MCP client
  2. feat mcp: read-only MCP server over tasks-export/1
  3. fix agent: watching a job of ai-desktop sends the control secret
  4. fix agent: confirm_run and drop_job prove the ai-desktop of the hand-over before the secret
  5. fix history: findings of the review of 94d02b0
  6. feat history: the overview figures are written down per day and area and read back as a series
  7. feat agent: a no to the question of :Tasks new --draft puts the waiting job of ai-desktop away
  8. fix agent: no secret goes to a port whose hub.json names no instance
  9. fix sheet-ai: ask refuses while setup({ ai = false }) turns the AI functions off
  10. fix agent: a watched job is read whole, not cut at the 64 KiB of the small routes
  11. fix agent-brief: --by takes only a name claim takes
  12. fix contract: the inverse of set_section is in the schema's Inverse

keys

j / k
next / previous line
gg / G
first / last line
⏎
open the line under the cursor
/
search plugins and apps (app: x or plugin: x narrows)
:
command line — Tab completes
:help x
vimdoc of a plugin (:e x = plugin page)
:ls · :apps · :play · :log · :stack
plugin list · app list · play area · activity stream · dependency graph
:log apps
the stream of one area (plugins or apps)
:colo x
colorscheme
:set skin=
modern | tui
?
this help
esc
close