Todo

Todo Plugin

Personal task management from any Claude Code session. Tasks are stored in a single markdown file with inline metadata tags.

Setup

Set the CYBERDECK_TASKS environment variable in your shell profile:

export CYBERDECK_TASKS="$HOME/workspace/obsidian/vaults/Meridian/tasks.md"

Install

# During development
claude --plugin-dir ./plugins/todo

# For persistent use
claude plugin install ./plugins/todo --scope user

Usage

/todo:todo add Fix auth bug @project(keystone) @priority(high) @due(2026-04-15)
/todo:todo complete auth bug
/todo:todo complete 3
/todo:todo reopen auth bug
/todo:todo reopen 3
/todo:todo update auth bug @priority(medium)
/todo:todo update 3 --desc "Fix auth bug in login flow"
/todo:todo remove old task
/todo:todo remove old task @reason(no longer relevant)
/todo:todo list
/todo:todo list @project(keystone) @priority(high)
/todo:todo list overdue
/todo:todo list completed

Task Format

Tasks are stored as markdown checkboxes with inline @tag(value) metadata:

- [ ] Task description @project(name) @priority(high) @due(2026-04-15) @created(2026-04-10) @id(1)

Task IDs

Every task is auto-assigned a unique @id(N) on creation, placed at the end of the task line. IDs are permanent and can be used to reference tasks in any command — either as @id(3) or just 3 (e.g., /todo:todo complete 3).

Metadata Tags

Tag	Description	Default
@id(N)	Unique task identifier	auto
@project(name)	Project association	none
@priority(high|medium|low)	Priority level	medium
@due(YYYY-MM-DD)	Due date	none
@created(YYYY-MM-DD)	Creation date	auto
@completed(YYYY-MM-DD)	Completion date	auto
@removed(YYYY-MM-DD)	Removal date	auto
@reason(text)	Removal reason	prompted

Validation

• @priority() must be high, medium, or low
• @due() must be a valid YYYY-MM-DD date
• @project() must be non-empty

Invalid values are rejected with a clear error message.

Commands

Command	Description
add	Create a new task in Active
complete / done	Move an active task to Completed
reopen	Move a completed or removed task back to Active
update	Change metadata or description (--desc "...") on an active task
remove / delete	Move an active task to Removed (with reason, inline or prompted)
list / ls / report	Display tasks with optional filters (combinable)