Mini Diary

📓 Mini Diary Skill

Your AI-powered mini diary. Small footprint, smart features.

✨ Features

📝 Simple Daily Logging: Clean Markdown format with date, weather, notes, and todos 🏷️ Smart Auto-Tagging: AI analyzes content and adds relevant tags automatically 🔍 Powerful Search: Search by tags, date, or content with context 📊 Basic Statistics: Tag frequency and completion rate tracking ☁️ Cloud Sync Ready: Optional NextCloud integration with detailed guide 🔓 Open Format: Plain Markdown files - you own your data

Installation

# Install via ClawHub clawhub install mini-diary

Basic Usage

# Add a note (auto-tagging happens automatically) mini-diary add "Met with client about P1S delivery" # Add a todo item (use [ ] for pending, [x] for completed) # The todo will be added to the current day's todo section echo "- [ ] Follow up with supplier" >> ~/diary.md echo "- [x] Submit monthly report" >> ~/diary.md # Search by tag mini-diary search --tag "📦" # Search by date mini-diary search --date "2024-02-22" # Search in content mini-diary search "client meeting" # View statistics mini-diary search --stats # List all available tags mini-diary search --list-tags

📁 Diary Format

• Mini Diary uses a simple Markdown format:
• # 📓 My Diary
• ## 📅 2024-02-22 Thursday
• ### 📝 Notes
• Met with client about P1S delivery 📦🎋
• Fixed heating issue on X1C printer 🔧🎋
• Submitted monthly invoice 💰
• ### ✅ Todos
• [ ] Follow up with supplier
• [x] Update inventory spreadsheet

Adding Todos

• Since todos are simple Markdown task lists, you can add them directly:
• # Add a pending todo
• echo "- [ ] Call client for follow-up" >> ~/diary.md
• # Add a completed todo
• echo "- [x] Submit weekly report" >> ~/diary.md
• # Add multiple todos
• cat >> ~/diary.md << 'EOF'
• [ ] Order more filament
• [x] Backup server data
• [ ] Schedule team meeting
• EOF

Todo Best Practices

Start with date: Ensure you're adding to the correct day's section Use clear descriptions: "Call John re: P1S delivery" not just "Call John" Update status: Change [ ] to [x] when completed Review daily: Check todos at start/end of each day

Finding Todos

# Search for pending todos grep "\[ \]" ~/diary.md # Search for completed todos grep "\[x\]" ~/diary.md # Count todos by status grep -c "\[ \]" ~/diary.md # Pending count grep -c "\[x\]" ~/diary.md # Completed count

🏷️ Auto-Tagging System

The AI automatically adds tags based on content: TagMeaningExample Triggers🏠Familyhome, family, household💰Financeinvoice, payment, accounting📦Orderorder, purchase, stock🚚Shippingshipping, delivery, logistics💻Techsoftware, system, computer🔧Supportrepair, fix, issue, problem🎋Bambubambu, 3d print, printer📋Formform, report, data, spreadsheet📅Daily(default for routine notes)

Setup

Set environment variable: export NEXTCLOUD_SYNC_DIR="/path/to/nextcloud/diary" Mini Diary will automatically sync to this directory.

⚠️ Important Notes

File Permissions: NextCloud requires specific file ownership: # After copying files to NextCloud directory: chown www-data:www-data /path/to/diary.md # Or using Docker: docker exec nextcloud_app chown www-data:www-data /var/www/html/data/... Scan Command Required: NextCloud won't detect changes automatically: docker exec nextcloud_app php occ files:scan [username]

Environment Variables

# Diary file location export DIARY_FILE="$HOME/my-diary.md" # NextCloud sync directory export NEXTCLOUD_SYNC_DIR="/path/to/nextcloud" # Custom tag definitions (JSON file) export TAGS_CONFIG="/path/to/tags.json"

Custom Tags

Create a JSON file to define custom tags: { "custom_tags": { "project-x": "🚀", "urgent": "⚠️", "meeting": "👥" }, "rules": { "project-x": ["project x", "px", "feature"], "urgent": ["urgent", "asap", "important"], "meeting": ["meeting", "call", "discussion"] } }

Weekly Report

# Generate weekly summary mini-diary search --date $(date -d "last week" +%Y-%m-%d) --stats

Tag Analysis

# See most used tags mini-diary search --stats | grep -A5 "Tag Statistics"

Export Data

# Export to CSV for analysis grep "^- " diary.md | sed 's/^- //' > notes.csv

Common Issues

Tags not appearing: Check content keywords match tag rules NextCloud files not showing: Did you run the scan command? Permission errors: Check file ownership in NextCloud directory Search not working: Ensure diary file exists and has content

Debug Mode

# Enable debug output export MINI_DIARY_DEBUG=1 mini-diary add "test note"

🤝 Contributing

Found a bug? Have a feature request? Contributions welcome! Fork the repository Create a feature branch Submit a pull request

📄 License

MIT License - see LICENSE file for details.

🙏 Acknowledgments

Built with OpenClaw Inspired by real-world need for simple, smart journaling Thanks to all contributors and users Mini Diary - Because journaling should be simple, smart, and yours.