FoamExtensions

A set of personal extensions for Foam, based on MCluck90/kaleidofoam

Original KaleidoFoam README

A kaleidoscope of features built for Foam.

I built these features to help my daily notes work better for me. My daily notes are formatted like this:

# $date

[[$weekly-note]]

[[$yesterday]] | [[$tomorrow]]

---

## TODO

## Log

Personally, I have most of the features here bound to a keyboard shortcut but this extension does not add these bindings for you.

Getting Started

Run FoamExtensions: Open Today to open your daily note.

Features

Daily Note

Command: foamextensions.openToday

Opens todays daily note and generates notes for the week.

Add to Log

Command: foamextensions.addToLog

Add a timestamped entry to the "Log" section.

Example:

## Log
- 10:42 Worked on writing up the README for KaleidoFoam

Add Todo

Command: kaleidofoam.addTodo

Adds a todo item to the "TODO" section.

Example:

## TODO
- [ ] Write up documentation for KaleidoFoam

Daily Edge Links

Command: foamextensions.generateDailyEdgeLinks

Adds links to the weekly, yesterday, and tomorrow notes for the current daily note.

Example:

[[week-of-2022-02-20_2022-02-26]]

[[2022-02-20]] | [[2022-02-22]]

Forward Todo

Command: foamextensions.forwardTodo

Forwards a note to a future date. Provides a dropdown recommending days in the next week.

Example:

- [>] Write up documentation for KaleidoFoam [[2022-02-22]]

Last Week Snippets

Snippets for referencing days in the last week.

• /last-sunday
• /last-monday
• /last-tuesday
• /last-wednesday
• /last-thursday
• /last-friday
• /last-saturday

Scheduled Notifications

Allows you to schedule notifications for a given todo item.

Example:

- [ ] 11:00 | Check email

By default, this will send a notification at 11:00 telling you to check your email. You can configure how long before the time to send the notification with the foamextensions.minutesBeforeNotifications setting.

NOTE: Only verified to work on Windows. I've had issues getting this to work on Linux.

Toggle Todo

Command: foamextensions.toggleTodo

Toggles a todo as complete or incomplete. Adds and removes a timestamp.

Example:

- [ ] Check email

becomes

- [x] Check email // 10:55

Toggle Todo Tags

Commands:

• foamextensions.toggleTodoTag.focus
• foamextensions.toggleTodoTag.urgent
• foamextensions.toggleTodoTag.optional

Toggles tags on a todo item.

Example:

- [ ] Check out that new VS Code extension @optional

Toggle Word Wrap Column

Command: foamextensions.toggleWordWrapColumn

Toggles the word wrap column width between 80 and 120 because that's what I like. This would be pretty easy to make configurable if anyone wants to submit a PR 😉

Weekly Notes

Commands:

• foamextensions.openLastWeek,
• foamextensions.openThisWeek,
• foamextensions.openNextWeek,

Generates and opens a weekly note. Contains references to all of the daily notes for that week and contains a TODO section.

Development

Generating the Changelog

Requires git cliff