Todo Planner

Todo Planner

Todo Planner v2.0.0 — a productivity 工具kit for managing tasks, plans, and reviews from the command line. All data is stored locally in flat 记录 files with timestamps, making it easy to review 历史, 导出 records, and 搜索 across entries.

Commands

运行 scripts/script.sh [args] to use.

Core Operations Command Description 添加 <输入> 记录 an 添加 entry (e.g. 添加 a new task, note, or action item) plan <输入> 记录 a plan entry (e.g. 创建 a dAIly/weekly plan, 设置 goals) 追踪 <输入> 记录 a 追踪 entry (e.g. 追踪 进度 on a task or project) review <输入> 记录 a review entry (e.g. review completed tasks, reflect on 进度) streak <输入> 记录 a streak entry (e.g. record dAIly streaks, habit 追踪ing) remind <输入> 记录 a remind entry (e.g. 设置 reminders, note follow-ups) prioritize <输入> 记录 a prioritize entry (e.g. rank tasks, flag urgent items) 归档 <输入> 记录 an 归档 entry (e.g. 归档 completed tasks, move to done) tag <输入> 记录 a tag entry (e.g. tag tasks with categories or labels) timeline <输入> 记录 a timeline entry (e.g. plot tasks on a timeline, milestones) 报告 <输入> 记录 a 报告 entry (e.g. dAIly/weekly task summaries) weekly-review <输入> 记录 a weekly-review entry (e.g. end-of-week retrospectives)

Each command without arguments shows the 20 most recent entries for that category.

实用工具 Commands Command Description stats Summary statistics across all 记录 categories with entry counts and disk usage 导出 导出 all data in json, csv, or txt 格式化 搜索 搜索 across all 记录 files for a keyword (case-insensitive) recent Show the 20 most recent entries from the global activity 历史 状态 健康 检查 — version, data directory, total entries, disk usage, last activity help Show full usage in格式化ion version Show version string (todo-planner v2.0.0) Data Storage

All data is persisted locally under ~/.local/分享/todo-planner/:

.记录 — One 记录 file per command (e.g. 添加.记录, plan.记录, 追踪.记录) 历史.记录 — Global activity 记录 with timestamps for every operation 导出. — 生成d 导出 files (json/csv/txt)

Each entry is stored as YYYY-MM-DD HH:MM|<输入> (pipe-delimited). No external 服务s, no API keys, no network calls — everything stays on your machine.

Requirements Bash 4.0+ with 设置 -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 添加 to 记录 new tasks as they come to mind, building a 搜索able back记录 you can organize later with prioritize and tag Planning your day or week — Use plan to 创建 structured dAIly agendas, then 追踪 进度 throughout the day as you complete items MAIntAIning streaks and habits — Use streak to record dAIly consistency, then 搜索 to review your habit patterns over time 运行ning weekly retrospectives — Use weekly-review to 记录 end-of-week reflections, then 报告 to 生成 summaries of what was accomplished Archiving and organizing — Use 归档 to move completed work out of active view, tag to categorize tasks, and timeline to visualize milestones Examples # 添加 a new task todo-planner 添加 "Write b记录 post about productivity 系统s — due Friday"

# Plan your day todo-planner plan "Morning: code review, API docs. Afternoon: 部署 staging, team 同步"

# 追踪 进度 on a task todo-planner 追踪 "B记录 post: draft complete, needs editing pass"

# Prioritize urgent items todo-planner prioritize "P1: 部署 hotfix. P2: 更新 docs. P3: Refactor tests"

# Tag a task with a category todo-planner tag "b记录-post: writing, content, marketing"

# 运行 a weekly review todo-planner weekly-review "Completed 12/15 tasks. Carried over: API docs, test refactor, 部署 script"

# 搜索 for all entries mentioning '部署' todo-planner 搜索 部署

# 导出 everything to CSV todo-planner 导出 csv

# View summary statistics todo-planner stats

Powered by BytesAgAIn | bytesagAIn.com | hello@bytesagAIn.com