Calmdown 📅

A minimalist calendar sidebar extension for VSCode that streamlines markdown note-taking and todo management.

Features ✨

• 📅 Calendar View: Clean, minimal calendar interface in the Explorer sidebar
• 📝 Journal Management: Automatically organize daily journal entries by date
• ✅ Todo Tracking: Visual indicators for days with open tasks
• 🚀 Quick Navigation: Click any date to open or create journal entries
• 📄 Template Support: Customizable journal templates with date substitution
• 📁 File Organization: Structured folder hierarchy (Year/Month/Day.md)

Visual Indicators 🎯

• 🟢 Green dot: Days with existing journal entries
• 🟠 Orange dot: Days with open todos (- [ ] items)
• 🔵 Blue underline: Today's date
• ✨ Highlighted: Selected date

Configuration ⚙️

Configure the extension through VSCode settings:

{
  "calmdown.basePath": "10 Personal/11 Journal",
  "calmdown.templatePath": "00 System/01 Templates/Daily Journal.md"
}

Settings 🛠️

• calmdown.basePath: Base folder for journal entries (relative to workspace root)
• calmdown.templatePath: Path to journal template file

File Structure 📂

The extension creates journal entries in this structure:

[basePath]/
├── 2025/
│   ├── 01 January/
│   │   ├── 01 Monday.md
│   │   ├── 02 Tuesday.md
│   │   └── ...
│   ├── 02 February/
│   └── ...
└── ...

Journal Templates 📋

Create a template file at your configured templatePath. Use {todays date} as a placeholder:

# {todays date}

## Today's Focus 🎯


## Notes 📝


## Reflections 💭


## Tomorrow's Goals 🚀

Usage 🎮

1. 📂 Open the Calendar view in the Explorer sidebar
2. 🖱️ Click any date to:
   • 📖 Open existing journal entry
   • ➕ Create new journal entry (with confirmation)
3. 👀 View open todos in the todo list below the calendar
4. 🔗 Click todos to navigate to their source file

Todo Detection 🔍

The extension automatically detects open markdown todos:

• - [ ] Task description ⏳ (open)
• - [x] Task description ✅ (completed - ignored)

Requirements 📋

• VSCode 1.100.0 or higher
• An open workspace folder 📁

Installation 💾

1. 📦 Package the extension: vsce package
2. 🔧 Install the .vsix file in VSCode

Development 👨‍💻

npm install
npm run compile

Watch mode:

npm run watch

License 📄

[Your License Here]