training-plan

Productivity and task management tool. Add tasks, set priorities, view daily and weekly plans, set reminders, track completion stats, and export your data. All data is stored locally in plain-text log files.

Commands

Data Storage

All data is stored locally at $TRAINING_PLAN_DIR or ~/.local/share/training-plan/ by default:

• data.log — Main data file with all items (date + description per line)
• history.log — Activity history with timestamps for every command run

Set the TRAINING_PLAN_DIR environment variable to use a custom data directory.

Requirements

• bash 4+
• Standard UNIX utilities (date, grep, wc)
• No external dependencies or API keys required

When to Use

1. Daily planning — Use add to capture tasks, then today to see what's on your plate
2. Weekly reviews — Run week to get an overview of everything scheduled this week
3. Priority management — Use priority to flag urgent items so you focus on what matters
4. Progress tracking — Check stats to see how many items you've logged and use done to mark completions
5. Data portability — Use export to dump all data to stdout for backup, piping, or integration with other tools

Examples

# Add a new task
training-plan add "Review project proposal by Friday"

# Add another task
training-plan add "Prepare slides for Monday meeting"

# List all current items
training-plan list

# See what's on today's schedule
training-plan today

# Mark a task as completed
training-plan done "Review project proposal"

# Set a task to high priority
training-plan priority "Prepare slides" high

# Set a reminder for tomorrow
training-plan remind "Submit expense report" tomorrow

# View weekly overview
training-plan week

# Check stats
training-plan stats

# Clear completed items
training-plan clear

# Export all data
training-plan export > backup.txt

# Show help
training-plan help

# Check version
training-plan version

Tips