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