✍️ HFL (Homework-for-Life)

Homework for Life
“What was the most story-worthy moment from my day?”

Not the biggest, not the most dramatic — just the one moment
that made today different from every other day.
If I had to tell one short story from today, which one would I choose?

---

What is HFL?

HFL is a minimal, powerful journaling tool designed to capture your daily moments with clarity.
It keeps your entire journal in a single, human-readable Markdown file — no clutter, no noise.

• 📝 Write in your favorite editor
• 🔄 Sync seamlessly with Notion
• 🌍 Access anywhere, anytime

One file. Infinite stories. A lifetime of reflection.

Why HFL?

🎯 One file, everywhere - Your entire journal in a single hfl.md file
📝 Write your way - Use any editor you love (VS Code, Vim, Nano, or Notion)
🔄 Always in sync - Seamless two-way sync with Notion
🚀 Future-proof - Plain Markdown that works with any tool

Quick Start

1. Install HFL

# Download from releases or build from source
git clone https://github.com/ahmaruff/hfl.git
cd hfl && go build -o hfl

2. Start writing

hfl edit                    # Open today's entry
hfl edit yesterday          # Yesterday's thoughts
hfl edit n+7               # Plan for next week

3. Sync with Notion (optional)

# Set up Notion integration
hfl config set notion.api_token "your-token"
hfl config set notion.database_id "your-db-id"

# Sync your journal
hfl sync                    # Two-way sync
hfl sync --push            # Local → Notion
hfl sync --pull            # Notion → Local

Your Journal, Your Way

# 2025-08-16
Had a breakthrough with the new project today.

The key insight was **simplicity over complexity**.

# 2025-08-15
Quiet morning. Read about minimalism.

Sometimes the best solutions are the simplest ones.

What Makes HFL Special?

🎪 Smart Date Parsing

hfl edit today             # Today
hfl edit n-3              # 3 days ago  
hfl edit monday           # Next Monday
hfl edit 2025-12-25       # Specific date

⚡ Instant Validation

• Auto-formats on save
• Warns about issues
• Keeps your journal clean

🔧 Flexible Configuration

hfl config set editor "code"           # VS Code
hfl config set editor "vim" --global   # Vim everywhere
hfl config list                        # See all options

📊 Rich Export Options

hfl export json -o backup.json        # JSON backup
hfl export csv -o analytics.csv       # Data analysis

Real-World Usage

Morning pages - hfl edit → write → auto-sync to Notion
Project logs - Track daily progress with timestamps
Travel journal - Write offline, sync when connected
Team updates - Share via Notion, edit locally

what's coming?

• 🔄 Conflict resolution
• 🎨 Rich markdown formatting in Notion
• 📊 Analytics and insights
• 🔗 Integration with more platforms
• 📱 Mobile companion app

Installation Options

Quick Install (Recommended)

Download from releases - binaries for Windows, macOS, and Linux.

Build from Source

git clone https://github.com/ahmaruff/hfl.git
cd hfl
go build -o hfl

Community

• 📖 Documentation - Complete guide
• 🐛 Issues - Bug reports & features
• 💬 Discussions - Community support

License

MIT License - your journal, your rules.

---

Start your journey: hfl edit

Simple journaling that grows with you.