Extension

patriceckhart/zot-todo

Interactive local todo dashboard for zot.

extension
repoissues

Install from GitHub and zot copies the extension into $ZOT_HOME/extensions/. Git-installed extensions update with zot update.

shell
zot ext install https://github.com/patriceckhart/zot-todo
repository
patriceckhart/zot-todo
author
patriceckhart
stars
0
forks
0
open issues
0
language
Python
license
MIT
topics
zot-extension
created
May 17, 2026
updated
May 17, 2026

Security note: zot extensions can execute code. Review the source before installing third-party extensions.

Readme

zot-todo

Interactive local todo dashboard for zot. Written in Python.

Install

zot ext install https://github.com/patriceckhart/zot-todo

Restart zot after installing.

Usage

Type:

/todo

This opens an interactive dashboard.

  Todos (1/3 done)

 ▸ ○ Fix login bug
   ○ Refactor auth module
   ✓ Set up CI pipeline

  ↑↓/jk navigate • x/space complete • a add • e edit • d delete • c clear done • Esc close

Keys:

Key Action
↑ / k Move up
↓ / j Move down
x / Space / Enter Toggle done/undone
a Add directly in the dashboard
e Edit selected todo directly
d / Delete Delete selected todo
c Clear completed todos
Esc / q Close

Command forms also work:

/todo add buy milk
/todo edit 1 buy oat milk
/todo done 1
/todo undone 1
/todo remove 1
/todo clear-done

Todos are stored locally in $ZOT_HOME/todos.json, or ~/.zot/todos.json if ZOT_HOME is not set. Override with ZOT_TODO_FILE=/path/to/todos.json.

License

MIT