Opening Settings
Access Settings from the menu bar (File → Settings, shortcut Cmd+,) or click the gear icon in the status bar.
Providers Tab
Selecting a Provider
Choose your AI provider from the dropdown: OpenCode Go, OpenCode Zen, or DeepSeek. Each provider has its own endpoint, model list, and API key.
Configuring an API Key
- Get your API key from the provider's website
- Paste it in the API Key field
- Click the validate button (checkmark icon)
- Green checkmark means the key is valid
- Red X means the key is invalid or the endpoint is unreachable
Keys are stored in your OS keychain (macOS Keychain), not in plaintext. The ~/.ignite/config.json file stores only provider metadata.
Model Selection
Model lists are cached in a local SQLite database and refreshed every 15 minutes. You can browse models even without an API key configured — Ignite shows a default list. When you configure a key, live models replace the defaults on the next refresh cycle.
Appearance Tab
Theme
Switch between dark mode (default) and light mode. The change applies immediately — no restart needed. Your preference is saved to ~/.ignite/config.json.
Default License
Choose from 9 common open-source licenses: MIT, Apache-2.0, GPL-3.0, AGPL-3.0, BSD-3-Clause, BSD-2-Clause, MPL-2.0, Unlicense, and Proprietary. This is used as the default when generating new projects.
Default Project Directory
Where Ignite writes output files. Defaults to ~/Development. Change this to your preferred workspace location.
Font
Choose from 10 monospace fonts. JetBrains Mono, Fira Code, IBM Plex Mono, Source Code Pro, and Roboto Mono are bundled with the app for offline use. Other fonts require system installation or fall back to your system monospace.
Configuration File
All settings are persisted in ~/.ignite/config.json. You can also edit this file directly if you prefer. The OS keychain stores API keys separately.