Settings Reference

Complete guide to configuring IfAI.

Opening Settings

• Keyboard: Cmd+, (Mac) or Ctrl+, (Windows/Linux)
• Menu: Gear icon in bottom left
• Command Palette: Cmd+Shift+P > "Open Settings"

AI Provider Settings

Provider Selection

Configure which AI service to use:

Provider	Best For	Pricing
OpenAI	Complex reasoning, creative tasks	Pay-per-use
Anthropic	Long conversations, nuanced explanations	Pay-per-use
Zhipu	Chinese language support	Pay-per-use
DeepSeek	Code generation, technical tasks	Pay-per-use
Ollama	Privacy, cost savings	Free (local)

OpenAI Configuration

1. API Key: Get from platform.openai.com
2. Model Selection:
   • gpt-4o - Best quality
   • gpt-4o-mini - Faster, cheaper
   • gpt-3.5-turbo - Legacy support

Anthropic Configuration

1. API Key: Get from console.anthropic.com
2. Model Selection:
   • claude-3-5-sonnet-20241022 - Best for coding
   • claude-3-opus-20240229 - Most capable

Zhipu Configuration

1. API Key: Get from open.bigmodel.cn
2. Model Selection:
   • glm-4 - Latest model
   • glm-4-flash - Faster responses

Ollama Configuration

1. Ollama URL: Default http://localhost:11434
2. Model Selection:
   • qwen2.5-coder:7b - Coding specialist
   • llama3.2 - General purpose
   • deepseek-coder - Code generation

Editor Settings

Appearance

Setting	Options	Description
Theme	Light, Dark, Auto	Editor color theme
Font Family	System fonts	Editor font
Font Size	12-24px	Text size
Line Height	1.0-2.0	Line spacing
Font Ligatures	On/Off	Character combinations

Code Editing

Setting	Options	Description
Tab Size	2, 4, 8	Spaces per tab
Insert Spaces	On/Off	Use spaces instead of tabs
Word Wrap	On, Off	Wrap long lines
Minimap	On, Off	Code overview on right
Line Numbers	On, Off	Show line numbers
Bracket Pairs	On, Off	Colorize matching brackets

Auto-Save

Setting	Options	Description
Auto Save	On, Off, After Delay	When to save
Auto Save Delay	100-10000ms	Delay before save

File Settings

File Associations

Configure how different file types are handled:

{
  "*.ts": "typescript",
  "*.py": "python",
  "*.rs": "rust"
}

Excluded Files

Files to hide from file tree:

{
  "node_modules": true,
  ".git": true,
  "*.log": true
}

Git Settings

Git Integration

Setting	Options	Description
Enable Git	On, Off	Show git status
Auto Refresh	On, Off	Auto-refresh git status
Decorations	On, Off	Show git decorators

Git Configuration

1. Git Path: Auto-detected or manual
2. User Name: Your git username
3. User Email: Your git email

Terminal Settings

Terminal Appearance

Setting	Options	Description
Font Size	12-24px	Terminal text size
Line Height	1.0-2.0	Terminal line spacing
Cursor Style	Block, Line, Underline	Cursor appearance

Shell Configuration

macOS:

# Default: /bin/zsh
# Or custom: /bin/bash, /usr/local/bin/fish

Windows:

# Default: PowerShell
# Or: WSL, Git Bash, CMD

Linux:

# Default: /bin/bash
# Or: /usr/bin/zsh, /usr/bin/fish

Keybinding Settings

Keybinding Schemes

Scheme	Description
VS Code	Default, familiar to most
IntelliJ	For IntelliJ IDEA users
Vim	Vim keybindings

Custom Keybindings

Edit keybindings JSON:

[
  {
    "key": "cmd+k",
    "command": "ai.chat.open"
  },
  {
    "key": "cmd+shift+k",
    "command": "composer.open"
  }
]

Advanced Settings

Performance

Setting	Options	Description
Telemetry	On, Off	Send usage data
Update Channel	Stable, Beta, Nightly	Update frequency

Experimental

Feature	Status	Description
New AI Features	Alpha	Early AI features
Advanced Symbols	Beta	Enhanced symbol indexing

Import/Export Settings

Export Settings

1. Settings > ... > Export Settings
2. Save to file

Import Settings

1. Settings > ... > Import Settings
2. Select settings file

Reset Settings

1. Settings > ... > Reset to Defaults
2. Confirm reset

Configuration File

Settings are stored at:

macOS:

~/Library/Application Support/IfAI/settings.json

Windows:

%APPDATA%\IfAI\settings.json

Linux:

~/.config/IfAI/settings.json

Next Steps

• Basic Usage - Core features
• Local LLM Setup - Local models
• Keyboard Shortcuts - Customize keybindings