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 🎮
- 📂 Open the Calendar view in the Explorer sidebar
- 🖱️ Click any date to:
- 📖 Open existing journal entry
- ➕ Create new journal entry (with confirmation)
- 👀 View open todos in the todo list below the calendar
- 🔗 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 💾
- 📦 Package the extension:
vsce package
- 🔧 Install the
.vsix file in VSCode
Development 👨💻
npm install
npm run compile
Watch mode:
npm run watch
License 📄
[Your License Here]
| |