Todo Planner
Todo Planner v2.0.0 — a productivity toolkit for managing tasks, plans, and reviews from the command line. All data is stored locally in flat log files with timestamps, making it easy to review history, export records, and search across entries.
Commands
Run scripts/script.sh <command> [args] to use.
Core Operations
| Command |
Description |
add <input> |
Log an add entry (e.g. add a new task, note, or action item) |
plan <input> |
Log a plan entry (e.g. create a daily/weekly plan, set goals) |
track <input> |
Log a track entry (e.g. track progress on a task or project) |
review <input> |
Log a review entry (e.g. review completed tasks, reflect on progress) |
streak <input> |
Log a streak entry (e.g. record daily streaks, habit tracking) |
remind <input> |
Log a remind entry (e.g. set reminders, note follow-ups) |
prioritize <input> |
Log a prioritize entry (e.g. rank tasks, flag urgent items) |
archive <input> |
Log an archive entry (e.g. archive completed tasks, move to done) |
tag <input> |
Log a tag entry (e.g. tag tasks with categories or labels) |
timeline <input> |
Log a timeline entry (e.g. plot tasks on a timeline, milestones) |
report <input> |
Log a report entry (e.g. daily/weekly task summaries) |
weekly-review <input> |
Log a weekly-review entry (e.g. end-of-week retrospectives) |
Each command without arguments shows the 20 most recent entries for that category.
Utility Commands
| Command |
Description |
stats |
Summary statistics across all log categories with entry counts and disk usage |
export <fmt> |
Export all data in json, csv, or txt format |
search <term> |
Search across all log files for a keyword (case-insensitive) |
recent |
Show the 20 most recent entries from the global activity history |
status |
Health check — version, data directory, total entries, disk usage, last activity |
help |
Show full usage information |
version |
Show version string (todo-planner v2.0.0) |
Data Storage
All data is persisted locally under ~/.local/share/todo-planner/:
<command>.log — One log file per command (e.g. add.log, plan.log, track.log)history.log — Global activity log with timestamps for every operationexport.<fmt> — Generated export files (json/csv/txt)
Each entry is stored as YYYY-MM-DD HH:MM|<input> (pipe-delimited). No external services, no API keys, no network calls — everything stays on your machine.
Requirements
- Bash 4.0+ with
set -euo pipefail
- Standard Unix utilities:
date, wc, du, grep, tail, cat, sed, basename
- No external dependencies or packages required
- No API keys or accounts needed
When to Use
- Capturing tasks quickly — Use
add to log new tasks as they come to mind, building a searchable backlog you can organize later with prioritize and tag
- Planning your day or week — Use
plan to create structured daily agendas, then track progress throughout the day as you complete items
- Maintaining streaks and habits — Use
streak to record daily consistency, then search to review your habit patterns over time
- Running weekly retrospectives — Use
weekly-review to log end-of-week reflections, then report to generate summaries of what was accomplished
- Archiving and organizing — Use
archive to move completed work out of active view, tag to categorize tasks, and timeline to visualize milestones
Examples
# Add a new task
todo-planner add "Write blog post about productivity systems — due Friday"
# Plan your day
todo-planner plan "Morning: code review, API docs. Afternoon: deploy staging, team sync"
# Track progress on a task
todo-planner track "Blog post: draft complete, needs editing pass"
# Prioritize urgent items
todo-planner prioritize "P1: Deploy hotfix. P2: Update docs. P3: Refactor tests"
# Tag a task with a category
todo-planner tag "blog-post: writing, content, marketing"
# Run a weekly review
todo-planner weekly-review "Completed 12/15 tasks. Carried over: API docs, test refactor, deploy script"
# Search for all entries mentioning 'deploy'
todo-planner search deploy
# Export everything to CSV
todo-planner export csv
# View summary statistics
todo-planner stats
Powered by BytesAgain | bytesagain.com | hello@bytesagain.com
1---2name: todo-planner3description: Organize todos with priorities, deadlines, and weekly views. Use when adding tasks, planning agendas, tracking progress, reviewing overdue items.4---5
6# Todo Planner
7
8Todo Planner v2.0.0 — a productivity toolkit for managing tasks, plans, and reviews from the command line. All data is stored locally in flat log files with timestamps, making it easy to review history, export records, and search across entries.
9
10## Commands
11
12Run `scripts/script.sh <command> [args]` to use.
13
14### Core Operations
15
16| Command | Description |
17|---------|-------------|
18| `add <input>` | Log an add entry (e.g. add a new task, note, or action item) |
19| `plan <input>` | Log a plan entry (e.g. create a daily/weekly plan, set goals) |
20| `track <input>` | Log a track entry (e.g. track progress on a task or project) |
21| `review <input>` | Log a review entry (e.g. review completed tasks, reflect on progress) |
22| `streak <input>` | Log a streak entry (e.g. record daily streaks, habit tracking) |
23| `remind <input>` | Log a remind entry (e.g. set reminders, note follow-ups) |
24| `prioritize <input>` | Log a prioritize entry (e.g. rank tasks, flag urgent items) |
25| `archive <input>` | Log an archive entry (e.g. archive completed tasks, move to done) |
26| `tag <input>` | Log a tag entry (e.g. tag tasks with categories or labels) |
27| `timeline <input>` | Log a timeline entry (e.g. plot tasks on a timeline, milestones) |
28| `report <input>` | Log a report entry (e.g. daily/weekly task summaries) |
29| `weekly-review <input>` | Log a weekly-review entry (e.g. end-of-week retrospectives) |
30
31Each command without arguments shows the 20 most recent entries for that category.
32
33### Utility Commands
34
35| Command | Description |
36|---------|-------------|
37| `stats` | Summary statistics across all log categories with entry counts and disk usage |
38| `export <fmt>` | Export all data in `json`, `csv`, or `txt` format |
39| `search <term>` | Search across all log files for a keyword (case-insensitive) |
40| `recent` | Show the 20 most recent entries from the global activity history |
41| `status` | Health check — version, data directory, total entries, disk usage, last activity |
42| `help` | Show full usage information |
43| `version` | Show version string (`todo-planner v2.0.0`) |
44
45## Data Storage
46
47All data is persisted locally under `~/.local/share/todo-planner/`:
48
49- **`<command>.log`** — One log file per command (e.g. `add.log`, `plan.log`, `track.log`)
50- **`history.log`** — Global activity log with timestamps for every operation
51- **`export.<fmt>`** — Generated export files (json/csv/txt)
52
53Each entry is stored as `YYYY-MM-DD HH:MM|<input>` (pipe-delimited). No external services, no API keys, no network calls — everything stays on your machine.
54
55## Requirements
56
57- **Bash** 4.0+ with `set -euo pipefail`
58- Standard Unix utilities: `date`, `wc`, `du`, `grep`, `tail`, `cat`, `sed`, `basename`
59- No external dependencies or packages required
60- No API keys or accounts needed
61
62## When to Use
63
641. **Capturing tasks quickly** — Use `add` to log new tasks as they come to mind, building a searchable backlog you can organize later with `prioritize` and `tag`
652. **Planning your day or week** — Use `plan` to create structured daily agendas, then `track` progress throughout the day as you complete items
663. **Maintaining streaks and habits** — Use `streak` to record daily consistency, then `search` to review your habit patterns over time
674. **Running weekly retrospectives** — Use `weekly-review` to log end-of-week reflections, then `report` to generate summaries of what was accomplished
685. **Archiving and organizing** — Use `archive` to move completed work out of active view, `tag` to categorize tasks, and `timeline` to visualize milestones
69
70## Examples
71
72```bash
73# Add a new task
74todo-planner add "Write blog post about productivity systems — due Friday"
75
76# Plan your day
77todo-planner plan "Morning: code review, API docs. Afternoon: deploy staging, team sync"
78
79# Track progress on a task
80todo-planner track "Blog post: draft complete, needs editing pass"
81
82# Prioritize urgent items
83todo-planner prioritize "P1: Deploy hotfix. P2: Update docs. P3: Refactor tests"
84
85# Tag a task with a category
86todo-planner tag "blog-post: writing, content, marketing"
87
88# Run a weekly review
89todo-planner weekly-review "Completed 12/15 tasks. Carried over: API docs, test refactor, deploy script"
90
91# Search for all entries mentioning 'deploy'
92todo-planner search deploy
93
94# Export everything to CSV
95todo-planner export csv
96
97# View summary statistics
98todo-planner stats
99```
100
101---
102
103Powered by BytesAgain | bytesagain.com | hello@bytesagain.com
bytesagain