Skip to content

Authentication

Swelog stores every credential in your operating system’s credential store — Keychain on macOS, Credential Manager on Windows, and the Secret Service on Linux. Nothing is written to swelog.json or any other file in your vault.

Credential Used by How it is obtained
GitHub token swelog fetch github Prompted on first use
OpenAI API key swelog summarize with "llm": "openAi" Prompted on first use
OpenRouter API key swelog summarize with "llm": "openRouter" Prompted on first use
Linear authorization swelog fetch linear Browser OAuth on first use
Google Calendar authorization swelog fetch google-calendar Browser OAuth on first use

Review what is stored — values are never printed:

Terminal window
swelog auth status

If a credential is revoked or rejected, clear it and run the command again to enter a new one. Every authorization error names this command:

Terminal window
swelog auth clear github
swelog auth clear --all

swelog auth clear accepts github, open-ai, open-router, linear, and google-calendar.

GITHUB_TOKEN, OPENAI_API_KEY, and OPENROUTER_API_KEY take precedence over the keyring when set. When one of these is set, swelog auth status reports it instead of the stored value.

Linear and Google Calendar are authorized through the browser and have no environment variable override.