Skip to content

foam daily

Show or create the daily note for a date.

foam daily [options]

Without --create, the command only reports whether the note exists. With --create, it writes the note if it doesn’t exist yet, using your daily note template if one is configured.

OptionDescription
--date <YYYY-MM-DD>Date to target (default: today)
--createCreate the note if it doesn’t exist
--path-onlyPrint only the resolved file path (useful for scripting)
--workspace <dir>Workspace root (default: FOAM_WORKSPACE env var, then current directory)
--format <fmt>Output format: text (default) or json

Show today’s daily note status:

Terminal window
foam daily
# journals/2024-01-15.md [exists]

Create today’s daily note:

Terminal window
foam daily --create

Get the path to a specific date’s note (for scripting):

/home/user/notes/journals/2024-01-10.md
foam daily --date 2024-01-10 --path-only

Open today’s note in your editor:

Terminal window
$EDITOR $(foam daily --create --path-only)

If no daily note template is configured, notes are created at journals/YYYY-MM-DD.md relative to the workspace root. If a template exists (.foam/templates/daily-note.md or .foam/templates/daily-note.js), the template determines the file path and content.

See Note Templates for how to configure daily note templates.

Published with Foam