tasks

Markdown Task Management

The task list lives in .llm/todo.md. Inspect and change it only through the scripts below: the file grows large, and the scripts return just the task you need instead of loading the whole list into context.

<plugin-root> is ${CLAUDE_PLUGIN_ROOT} in Claude Code. In Codex, it is the plugin root that contains this skills/tasks/SKILL.md file.

Every script exits 0 on success and 1 on error.

Scripts

task_get.py - Extract Next Task

python <plugin-root>/scripts/task_get.py .llm/todo.md

Prints the first [ ] task with all indented context lines below it. Exits 1 when the file does not exist.

To see more of the queue, select incomplete tasks by 1-based position. Positions count only [ ] tasks; [x], [!], and [>] tasks are skipped.

python <plugin-root>/scripts/task_get.py .llm/todo.md --index 3
python <plugin-root>/scripts/task_get.py .llm/todo.md --range 1-10
python <plugin-root>/scripts/task_get.py .llm/todo.md --limit 10

Each selected task prints as its checkbox line and context, with a blank line between tasks. --index and a --range that starts past the last incomplete task exit 1; a --range or --limit that runs past the end prints the tasks that exist.

task_add.py - Add New Task

python <plugin-root>/scripts/task_add.py .llm/todo.md "Task description
  Context line 1
  Context line 2"

Appends a [ ] task, creating .llm/todo.md if needed and preserving indentation in multi-line strings.

Add a batch of tasks in one shell command, chaining one call per task with &&, so concurrent sessions writing the same file are unlikely to interleave:

python <plugin-root>/scripts/task_add.py .llm/todo.md "First task
  Context line 1" && \
python <plugin-root>/scripts/task_add.py .llm/todo.md "Second task"

task_mark.py - Mark Task

python <plugin-root>/scripts/task_mark.py .llm/todo.md
python <plugin-root>/scripts/task_mark.py .llm/todo.md --marker='!' --reason='precommit failed on the parser rewrite'