DocsConfigure & CustomizeConfiguration8 min read
Documentation

Configuration

Every setting lives in one place: Settings (Ctrl+,). Changes save automatically to your local database.

API keys

WindOp reaches 350+ models through OpenRouter with a single key.

  1. Create a key at openrouter.ai/keys.
  2. Open SettingsGeneral → API & Authentication and paste it (it looks like sk-or-v1-…).

The key is stored in your operating system's secure credential storage, not in a plain text file. If you are on WindOp Pro, you can skip the key and use hosted credits; choose who pays under SettingsAccount.

Settings map

WhereWhat you configure
GeneralAPI key, the global “summon WindOp” hotkey, voice input, launch on startup, task-complete notifications, Smart Prompt, app updates, anonymous analytics opt-out
ModelsDefault model, per-role team models, favorites, context cost mode
OpenRouterProvider routing, reasoning, image/video/speech generation
Web ToolsSearch provider and page reader
ToolsEnable/disable tools and MCP servers
SecurityConfirmation prompts and saved command permissions
UsageSpend history, daily and session limits, warning threshold
ObservabilityLocal traces, token/cost/latency stats, optional Langfuse export
StorageDisk use and cleanup for media and caches

General highlights

Global hotkey

The default is CommandOrControl+Shift+N, which brings WindOp forward from anywhere. Change it in Keyboard & Input.

Voice input

Turn on Enable Voice Input to dictate messages with your microphone.

Smart Prompt

Rewrites vague messages using the conversation for context and shows an Original vs Enhanced comparison. Enable Send rewrites without preview to skip the comparison.

Startup & notifications

Launch on System Startup starts WindOp when you sign in (needed for always-on scheduled tasks). Notify When Tasks Complete alerts you when long tasks finish.

Keep costs under control

In SettingsUsage you can set a daily limit, a session limit, and a warning threshold. The page also charts the last 30 days of spending and breaks cost down by model.

Tip

If a task is getting expensive, switch to a smaller model with Ctrl+M or start a fresh chat — long conversations resend more context every turn.

Understand what it is doing

SettingsObservability records local traces: requests, tokens, cost, average latency, success rate, and tool calls. Data stays on your device unless you opt in to Langfuse export.

Environment variables

Environment variables are optional and meant for advanced setups and development. Prefer the Settings UI for normal use.

What's next

Something missing or out of date? Tell us on the community page.