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?

• Works entirely offline — your personal goals never leave your machine
• No external dependencies or accounts needed
• Every action is timestamped and logged for full auditability
• Export your history to JSON, CSV, or plain text anytime
• Simple CLI interface with consistent command patterns

Commands

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

• With arguments — logs the input with a timestamp and saves to its dedicated log file
• Without arguments — displays the 20 most recent entries from that command's log

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:

• check.log, validate.log, generate.log, format.log, etc. — per-command log files
• history.log — unified activity log across all commands
• export.json, export.csv, export.txt — generated export files

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

Requirements

• Bash 4.0+ (uses set -euo pipefail)
• Standard Unix tools: date, wc, du, tail, grep, sed, cat
• Works on Linux and macOS
• No external packages or network access required

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.

Powered by BytesAgain | bytesagain.com | hello@bytesagain.com