DeckMaster – interactive due-date triage for Taskwarrior

When to use

• End-of-day shutdown – clear today's list and push leftovers to tomorrow in < 60 s
• Weekly GTD review – run deckmaster o, bulk-select everything that can wait, hit 7 and you're done
• Morning stand-up – refresh, complete what shipped overnight, reschedule blockers
• Inbox zero – import e-mail tasks, blast through them with single keys

What it does

• Shows today / yesterday / overdue tasks one-by-one in rich panels
• Single-key actions:
  1-9 → +N days
  0 → today
  c → mark done (with optional annotation)
  d → delete
  b → bulk-checkbox mode (multi-select + mass-action)
  r → refresh (newly added tasks appear at the end)
• Smart re-schedule: tasks older than yesterday are bumped from today, not from their stale due-date
• Time-zone aware, emoji age-indicators, optional duration / value / CP fields
• Dry-run feel: nothing is executed until you confirm; Ctrl-C leaves your DB untouched

Install

Python ≥ 3.8

pip install rich dateutil pytz      # required
pip install questionary             # optional (nicer batch UI)

curl -LO https://raw.githubusercontent.com/catanadj/taskwarrior-deckmaster/main/DeckMaster.py
chmod +x DeckMaster.py

---

Usage

./deckmaster.py              # today (default)
./deckmaster.py overdue      # blaze through backlog (short use "o")
./deckmaster.py yesterday -b # batch-process what slipped (short "y")

Configuration

DeckMaster reads a small key/value config file named deckmaster.conf from the same directory as DeckMaster.py.

theme = "default"  # terminal foreground, works on light and dark backgrounds
default_view = "today"
default_action = "1"
batch_default_action = "1"
show_session_summary = true

Run ./deckmaster.py --help to see the active theme and loaded config path. Run ./deckmaster.py --doctor for read-only setup diagnostics.

Available themes:

Theme	Use
default	Inherit normal text from the terminal foreground
dark	Keep the original white/cyan-heavy styling
light	Use darker accents for light terminal backgrounds

Config options:

Setting	Use
default_view	View to open when no view is passed: today, yesterday, or overdue
default_action	Default action for the per-task prompt
batch_default_action	Default action for batch mode
show_session_summary	Show updated/completed/deleted/skipped/remaining counts at exit

Keys

Key	Action
1-9	postpone N days
0	set due today
c [note]	complete (with annotation)
d	delete
b	batch multi-select
r	refresh queue
u	undo last interactive action
s	skip
q	quit

Support

If you find this tool helpful, any support will be greatly apreciated.

You can do so here. Thank you.

---