Lifegoals

Lifegoals

A command-line devtools toolkit for tracking and managing life goals. Check, validate, generate, format, lint, explain, convert, template, diff, preview, fix, and report on your goals — all from your terminal with persistent logging and full activity history.

Why Lifegoals?

Commands

| Command | Description | |---------|-------------| | lifegoals check | Check goal entries for completeness; view recent checks without args | | lifegoals validate | Validate goal structure, format, and feasibility | | lifegoals generate | Generate new goal ideas or milestone breakdowns | | lifegoals format | Format goal data for readability or presentation | | lifegoals lint | Lint goals for vague language or missing deadlines | | lifegoals explain | Explain a goal's structure and progress path | | lifegoals convert | Convert goal data between different formats | | lifegoals template | Create or apply goal templates for common objectives | | lifegoals diff | Diff two goal snapshots to track changes over time | | lifegoals preview | Preview goal output or milestone timeline | | lifegoals fix | Auto-fix common issues in goal definitions | | lifegoals report | Generate a progress report on your goals | | lifegoals stats | Show summary statistics across all actions | | lifegoals export | Export all logs (formats: json, csv, txt) | | lifegoals search | Search across all log entries | | lifegoals recent | Show the 20 most recent activity entries | | lifegoals status | Health check — version, disk usage, entry count | | lifegoals help | Show help with all available commands | | lifegoals version | Print current version (v2.0.0) |

Each data command (check, validate, generate, etc.) works in two modes:

Getting Started

# See all available commands
lifegoals help
Check current system status
lifegoals status
View statistics across all commands
lifegoals stats

Data Storage

All data is stored locally in ~/.local/share/lifegoals/. The directory structure:

Modify the DATA_DIR variable in script.sh to change the storage path.

Requirements

When to Use

1. Setting new life goals — use lifegoals generate to brainstorm objectives and lifegoals template to apply proven goal-setting frameworks like SMART goals 2. Breaking goals into milestones — run lifegoals check and lifegoals validate to ensure each goal has clear, actionable steps and deadlines 3. Tracking progress over time — use lifegoals diff to compare goal snapshots at different dates and lifegoals report to generate progress summaries 4. Reviewing and refining goals — run lifegoals lint to catch vague language, then lifegoals fix to tighten up weak goal definitions 5. Exporting goal data for sharing — use lifegoals export and lifegoals convert to transform your goal history into JSON, CSV, or text for journals, coaches, or planning tools

Examples

# Check a goal for completeness
lifegoals check "Learn Spanish to B2 level by December 2026"
Validate a goal's structure
lifegoals validate "Run a marathon — target: sub-4-hours"
Generate milestone ideas for a goal
lifegoals generate "Save $50k emergency fund"
Lint a goal for vague language
lifegoals lint "Get healthier somehow"
Format goal data for presentation
lifegoals format "Career: Get promoted to senior engineer"
Create a goal from a template
lifegoals template "fitness-90-day-challenge"
Diff two goal snapshots
lifegoals diff "Q1-goals vs Q2-goals"
Generate a progress report
lifegoals report "2026-goals"
View summary statistics
lifegoals stats
Export all history as JSON
lifegoals export json
Search for goals mentioning fitness
lifegoals search "fitness"
View recent activity
lifegoals recent

Output

All commands output structured text to stdout. You can redirect output to a file:

lifegoals report annual-review > review.txt
lifegoals export csv

Configuration

The data directory defaults to ~/.local/share/lifegoals/. Modify the DATA_DIR variable at the top of script.sh to customize the storage path.

# Check a goal for completeness
lifegoals check "Learn Spanish to B2 level by December 2026"
Validate a goal's structure
lifegoals validate "Run a marathon — target: sub-4-hours"
Generate milestone ideas for a goal
lifegoals generate "Save $50k emergency fund"
Lint a goal for vague language
lifegoals lint "Get healthier somehow"
Format goal data for presentation
lifegoals format "Career: Get promoted to senior engineer"
Create a goal from a template
lifegoals template "fitness-90-day-challenge"
Diff two goal snapshots
lifegoals diff "Q1-goals vs Q2-goals"
Generate a progress report
lifegoals report "2026-goals"
View summary statistics
lifegoals stats
Export all history as JSON
lifegoals export json
Search for goals mentioning fitness
lifegoals search "fitness"
View recent activity
lifegoals recent

The data directory defaults to ~/.local/share/lifegoals/. Modify the DATA_DIR variable at the top of script.sh to customize the storage path.