📝 JOURNI - Your Digital Journal Companion

A beautiful, feature-rich command-line journaling tool that makes writing and organizing your thoughts a delightful experience.

✨ Features

• 🎨 Beautiful Interface - Gradient text, animations, and ASCII art
• 📊 Smart Statistics - Track your writing progress and patterns
• 🔍 Powerful Search - Find any entry by content or date
• 🌈 Mood Tracking - Log your emotions with emoji indicators
• 🏷️ Tagging System - Organize entries with hashtags
• 📖 Easy Browsing - Navigate through your entries by date
• ✏️ Flexible Editing - Append to or replace existing entries
• 📈 Detailed Analytics - View your journaling insights

🚀 Installation

Global Installation (Recommended)

npm install -g journi
journi

Local Installation

npx journi

🎯 Usage

Simply run the command and follow the interactive prompts:

journi

Main Features:

📝 Create New Entry

• Select your mood for the day
• Add a title and write your thoughts
• Tag your entry for easy organization
• Automatic timestamps and metadata

✏️ Edit Previous Entries

• Find entries by date
• Append new content or replace entirely
• Maintains edit history with timestamps

📖 Read & Browse

• View any past entry by date
• Browse chronologically by year and month
• Beautiful formatted display

🔍 Search Your Thoughts

• Search across all entries by content
• Preview matching entries
• Quick access to relevant memories

📊 Analytics Dashboard

• Total entries and word counts
• Mood distribution analysis
• Longest and shortest entries
• Monthly and yearly breakdowns

📁 File Organization

JOURNI organizes your entries in a clean folder structure:

your-project-folder/
├── 2024/
│   ├── 01/
│   │   ├── journal-01.txt
│   │   ├── journal-15.txt
│   │   └── journal-28.txt
│   └── 02/
│       └── journal-14.txt
└── 2025/
    └── 03/
        └── journal-10.txt

🛠 Requirements

• Node.js 14.0.0 or higher
• Your favorite text editor (for writing longer entries)

🎨 Customization

JOURNI stores all entries as simple text files in an organized folder structure, making it easy to:

• Back up your journals
• Sync across devices
• Import/export to other tools
• Customize the storage location

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

MIT License - see LICENSE file for details.

🌟 Why JOURNI?

• Privacy First: All data stored locally on your machine
• Simple but Powerful: Easy to use with advanced features when you need them
• Beautiful Experience: Makes journaling enjoyable with thoughtful design
• Cross-Platform: Works on Windows, macOS, and Linux
• Lightweight: Fast startup and minimal resource usage

Start your journaling journey today with JOURNI! ✨

npm install -g journi
journi