docs/user/tools/cli/daily.md
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.
| Option | Description |
|---|---|
--date <YYYY-MM-DD> | Date to target (default: today) |
--create | Create the note if it doesn't exist |
--path-only | Print 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:
foam daily
# journals/2024-01-15.md [exists]
Create today's daily note:
foam daily --create
Get the path to a specific date's note (for scripting):
foam daily --date 2024-01-10 --path-only
# /home/user/notes/journals/2024-01-10.md
Open today's note in your editor:
$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 [templates] for how to configure daily note templates.