jn - Journal Notes CLI

A simple, fast journal note-taking CLI tool built with Bun.

Features

• 📝 Quick daily journal entries with timestamps
• 🏷️ Tag your entries for better organization
• 📅 Automatic daily file creation (YYYY-MM-DD.md)
• 📂 Open notes folder in Neovim with jn (no args)
• ⚡ Built with Bun for maximum performance

Installation

Install globally with Bun

bun add -g jn

Install from source

git clone https://github.com/athasdev/jn.git
cd jn
bun install
bun link

Usage

Quick note entry

jn This is my journal entry for today

Add tags to your entry

jn -t work,meeting Today I had an important meeting
jn --tags personal,health Went for a run this morning

Open notes folder (no arguments)

jn

This opens your ~/notes directory in Neovim.

File Structure

Notes are stored in ~/notes/ with daily files:

~/notes/
├── 2025-01-15.md
├── 2025-01-16.md
└── 2025-01-17.md

Each daily file has this format:

# 2025-01-17

## [14:30] #work #meeting
Today I had an important meeting about the new project.

## [16:45] #personal
Went for a coffee with friends.

Requirements

• Bun >= 1.0.0
• Neovim (optional, for opening notes folder)

License

MIT