Settings & Preferences
Gestura has several places where behavior can be configured. The key is knowing which surface is best for each kind of change.
Use the GUI for everyday preferences
- Voice mode and microphone selection
- Wake-word behavior and interaction style
- Notifications, sounds, and haptic feedback
- General trust and UX settings you revisit often
Use config.yaml for durable system behavior
- Providers and model defaults
- MCP servers and scopes
- Permission defaults
- Paths, timeouts, and advanced toggles
Use secure storage for secrets
Sensitive API keys should migrate to the system keychain rather than living permanently in plain config. Gestura includes secure-storage support and migration helpers for this reason.
Use environment variables for overrides
Environment variables are best when you need machine-specific overrides, CI integration, or temporary provider changes without editing the main configuration file.
A safe settings workflow
- Change one category at a time.
- Validate the config after larger edits.
- Test the affected capability immediately.
- Only then move on to the next tuning pass.