ConfigurationSettings & AI Engines
Configure upd CLI via the interactive wizard or upd settings. Override scan period and AI engine per run with CLI flags — useful for agents and one-off recaps.
Interactive settings
Config is stored under your OS user config directory (e.g. ~/.config/upd-cli/ on Linux). Daily drafts live in updates/YYYY-MM-DD.md.
CLI overrides (per run)
Flags -p/--period, --ai, --json, and -y/--yes work on all main commands. See AI Agents for the full list.
Configuration keys
| Key | Type | Default | Description |
|---|---|---|---|
| workDir | string (path) | ~/ | Root folder where your git projects live. upd scans nested repos here. |
| aiEngine | codex | claude | gemini | grok | ollama | custom | codex | Which local AI CLI binary upd invokes to format the standup. |
| customAiCommand | string | "" | When aiEngine is custom: shell template with {prompt} placeholder. |
| gitUsername | string | from git config | Author name used to filter commits (user.name). |
| gitEmail | string | optional | Optional email filter for commit authorship. |
| slackUserToken | string (xoxp-...) | "" | Slack User OAuth token to post as yourself via Web API. |
| slackChannelId | string (C...) | "" | Target channel ID for standup posts. |
| scanDays | number | 1 | Default days back to scan commits (overridable with --period). |
| systemPrompt | string | built-in template | Custom AI prompt for standup formatting. Editable in settings. |
Supported AI engines
upd shells out to AI CLIs already on your PATH — not remote OpenAI API keys inside upd itself. List what is installed:
codexCodex (OpenAI)
Uses the codex CLI on your PATH.
claudeClaude (Anthropic)
Uses claude -p for one-shot prompts.
geminiGoogle Gemini CLI
Requires gemini binary installed.
grokGrok (xAI)
Requires grok binary installed.
ollamaOllama (local)
Runs a local model (default qwen2.5:3b). Fully private.
customCustom template
Any command with {prompt} placeholder.
Ollama (recommended for privacy)
Run Llama, Qwen, Mistral, and other models locally. Commit metadata never leaves your device when Ollama handles formatting. Install from ollama.com and ensure the ollama binary is on your PATH.