Commands

Run swelog --help, or swelog <command> --help, to see this information from the CLI itself.

Setup

Command	Behavior
swelog init	Create a default swelog config file.
swelog init --force	Overwrite an existing config file with defaults.
swelog setup	Create the swelog files in your Obsidian vault.
swelog setup --force	Recreate and overwrite configured swelog files.
swelog config	Display your current configuration and where it is stored.

Capturing work

Write the day’s notes into WORK.md yourself, in Obsidian or any editor.

Command	Behavior
swelog reset	Reset your work file to the default Focus-and-Log template.

Filing the day

Command	Behavior
swelog log	Write your work file into the daily folder and reset it. No LLM.
swelog log --date MM-DD-YYYY	Write the daily log for the supplied date. Defaults to today.
swelog log --yesterday	Write the daily log for yesterday.
swelog log --force	Overwrite an existing daily log file.
swelog log --keep	Keep the current contents of the work file.

The daily log is your work file verbatim, with its heading replaced by # Daily Log - MM-DD-YYYY.

Summarizing (optional)

Requires llm and llmModel in your config. See Summarization.

Command	Behavior
swelog summarize	Alias for swelog summarize day.
swelog summarize day	Summarize your work file into the daily folder and reset it.
swelog summarize day --date MM-DD-YYYY	Write the daily log for the supplied date. Defaults to today.
swelog summarize day --yesterday	Write the daily log for yesterday.
swelog summarize day --force	Overwrite an existing daily log file.
swelog summarize day --keep	Keep the current contents of the work file.
swelog summarize week	Summarize the current week of daily logs into a weekly log.
swelog summarize week --week-of MM-DD-YYYY	The Monday of the week you want to summarize.
swelog summarize week --last-week	Summarize the previous week instead of the current one.
swelog summarize week --force	Overwrite an existing weekly log file.

See Summarization for the rules that govern each.

Fetching integration activity

Command	Behavior
swelog fetch github	Fetch the PRs you opened and merged on a date.
swelog fetch github --date MM-DD-YYYY	Date to fetch GitHub activity for.
swelog fetch github --yesterday	Fetch yesterday’s GitHub activity.
swelog fetch google-calendar	Fetch the meetings you had on a date.
swelog fetch google-calendar --date MM-DD-YYYY	Date to fetch meetings for.
swelog fetch google-calendar --yesterday	Fetch yesterday’s meetings.
swelog fetch linear	Fetch the issues assigned to your username.
swelog fetch linear --date MM-DD-YYYY	Date to fetch Linear activity for.
swelog fetch linear --yesterday	Fetch yesterday’s Linear activity.

See GitHub, Google Calendar, and Linear.

Managing credentials

Command	Behavior
swelog auth status	Show which credentials are stored, without printing them.
swelog auth clear <credential>	Remove a stored credential so the next command asks for it again.
swelog auth clear --all	Remove every stored credential.

<credential> is one of github, open-ai, open-router, linear, or google-calendar. See Authentication.

Relative date flags

--yesterday saves you working out yesterday’s date. On 08-21-2026, these two do the same thing:

swelog fetch github --yesterday
swelog fetch github --date 08-20-2026

--last-week works the same way for swelog summarize week. That command defaults to the Monday of the week containing today, so --last-week picks the Monday one week earlier. Run on a Monday, it summarizes the week that just ended.

You cannot use both flags at once. --date with --yesterday, or --week-of with --last-week, gives an error.