Configure

Settings reference

Open Settings from the gear in the title bar. Settings can't be changed while recording.

#Microphone

SettingDefault
Record my voiceOn
MicrophoneSystem Default
Record the other side too (meetings)Off

#Transcription

SettingDefault
Language (spoken)Auto
EngineOn device (free)
Model (on device)large-v3-turbo (recommended)
Endpoint Base URL / Model (compatible)empty
OpenAI API key / Endpoint API key (optional)not set
Cost capUp to $1 per review

See Transcription and costs.

#Storage

SettingDefault
Keep recordings: 7 days / 30 days / Forever7 days
Stay on the feedback screen after stoppingOff

#Agents

SettingDefault
Start When a Project OpensClaude Code, Codex (pick any supported agents, or none)
Show <agent> in menusOn for every agent
Start agents without permission promptsOn: Claude Code starts with --dangerously-skip-permissions, Codex with --dangerously-bypass-approvals-and-sandbox (details)
Notify me when agents finish or need meOff (details)
Command / arguments (per agent)The agent's own command (for example claude, codex, gemini) / --chrome for Claude Code, none for the others
Custom AgentsNone (Add Custom Agent registers any CLI)
Instructions for AgentBuilt-in text (variables)
Terminal shell (Windows)PowerShell: PowerShell 7 (pwsh) when installed, otherwise Windows PowerShell. It keeps your command history across tabs and restarts. cmd.exe is the other choice (agents.windowsShell in settings.json). Applies to tabs opened afterwards

#Switch on usage limits

SettingDefault
Switch automatically when a usage limit is reachedOn
Count an account as at its limit from95%
Try another account of the same agent firstOn
Agent orderClaude Code, Codex, Gemini CLI
Move back to a higher agent when its limit resetsOff

In Settings → Accounts. Work is handed over through .ferret/handoff.md in the project. See Keep working at usage limits.

#Accounts, service CLIs, appearance, language

  • Accounts: see Accounts and usage.
  • Service CLIs: install and sign in to service CLIs. See Service CLIs.
  • Import from browsers: bring passwords (from an exported CSV) and history into the built-in browser. See Import passwords and history.
  • Appearance → Theme: System (default), Light, Dark.
  • Language → Interface: System (default; follows the OS language when Ferret has it, English otherwise) English or 日本語.

From the footer: terminal position (right / bottom) and the microphone toggle.

#settings.json

Everything above is stored in ~/.ferret/settings.json (same path on every OS), with a JSON Schema next to it. You can edit it while the app is running, by hand or with your coding agent; changes apply immediately. See Configure with settings.json.

Edit this page on GitHub (opens in a new tab)