Configuration

Swelog stores its configuration in swelog/swelog.json inside your operating system’s configuration directory. All generated files and directories live inside <obsidianVaultPath>/<swelogFolderName>.

Fields

Field	Required	Description
obsidianVaultPath	Yes	Absolute path to the Obsidian vault. Commands fail until this is configured.
swelogFolderName	Yes	Folder created inside the vault for swelog files.
workFileName	Yes	Markdown file used to collect the current day’s raw notes.
dailyLogFolderName	Yes	Directory containing generated daily logs.
weeklyLogFolderName	Yes	Directory containing generated weekly logs.
contextFileName	Yes	Markdown file containing role, team, systems, and priority context. Used by summarization only.
llm	No	Summarization provider: ollama, openAi, or openRouter. Set only when you use swelog summarize.
llmModel	No	Model identifier interpreted by the configured provider. Set only when you use swelog summarize.
linearUsername	No	Exact Linear assignee name used by swelog fetch linear. Omit when Linear is not used.

swelog init writes only the required fields. The optional ones are absent until you add them by hand, so a config that has never been edited works with swelog log, swelog fetch, and everything else that does not need a model.

Viewing the current configuration

Display the current configuration and its location:

swelog config

Credentials

Never store API keys or tokens in swelog.json. Swelog keeps every credential in your operating system’s credential store — see Authentication.