Skip to main content

Settings

Open Settings with ⌘/Ctrl+, or from the account menu at the bottom of the sidebar. On macOS, it's also Settings… in the app menu. Most settings save as soon as you change them. The ones that need a restart have their own Save & restart button.

Account​

SettingWhat it does
Avocado ConnectSigned out, it shows Sign in with browser. Signed in, it shows who you are and your account details.
Active profileSwitches between Avocado Connect profiles, the same profiles the Avocado CLI uses.
AppearanceDark Mode (the default) or Avocado Classic. Every window follows the theme, including the terminal and the editor.
Sign outUnder Danger Zone. It signs out of Avocado Connect, in both Desktop and the CLI.

Agent​

Picks the agent's backend and configures it. See Agent.

Claude Code and OpenAI Codex:

SettingWhat it does
Command, Args, Working dirHow Desktop starts the agent. The defaults work; change them only to run a different build of the agent. The working directory defaults to your home directory.
Force subscription billingClaude Code only, on by default. It ignores ANTHROPIC_API_KEY, so you're billed through your Claude plan rather than the API.
MCP serversTest connection checks that the agent can reach the Avocado MCP.
External clientsA configuration snippet for using Desktop's MCP server from another MCP client.

Microclaw runs the agent inside the build VM:

SettingWhat it does
EnabledRuns the agent in the VM. Off by default.
Provider, Model, Base URLThe model to use. Defaults to Anthropic.
API keyThe provider's API key. It shows Not set until you add one.
SafetyConfirm before high-risk tools, on by default and recommended.
avocado-os serverGives the agent the public avocado-os MCP server. Optionally, it can use a local copy instead.

Click Save & restart agent to apply changes. MCP host server shows the address of Desktop's own MCP server.

Virtual machine​

Sizes and manages the build VM on macOS. See Build VM.

SettingWhat it does
CPU cores1 to 12. Save & restart VM applies it.
Memory1 to 32 GiB, in 512 MiB steps. Save & restart VM applies it.
DiskUp to 1024 GiB. Grow disk & restart VM applies it. The disk can grow but not shrink.
Hibernate afterIdle seconds before the VM hibernates. 0 turns automatic hibernation off.
Reset /var…Under Danger Zone. It erases everything stored in the VM, and you type RESET to confirm.

The sliders turn amber past half of your computer's resources and red past three quarters.

Environment​

SettingWhat it does
Terminal appThe terminal that Open in Terminal uses. Auto-detect, or pick one Desktop found, such as iTerm, Ghostty, WezTerm or Alacritty.
Projects locationWhere new projects are created. The default is ~/Avocado/Projects.
VM artifact overrideUses a local VM image instead of the released one. For testing a VM build.
CLI binaryOverride path runs a different Avocado CLI from the one the app includes.
CLI environment overridesValues passed to every CLI run: the package repository URL (AVOCADO_REPO_URL), the distro release and channel, and the VM channel URL base. Reset to defaults… clears them.

Leave the CLI overrides empty unless you're pointing Desktop at a different package feed. A project's own distro block in avocado.yaml normally decides the release and channel. See Configuration.

Shortcuts​

ActionDefault
Install⌘/Ctrl+I
Build⌘/Ctrl+B
Provision⌘/Ctrl+P
Deploy⌘/Ctrl+D
Search packages⌘/Ctrl+E

Click a shortcut to record a new one. Esc cancels, and ↺ restores the default. Desktop flags a shortcut that clashes with another one.

These shortcuts are fixed: Settings ⌘/Ctrl+,, and zoom ⌘/Ctrl with +, − or 0.

Updates​

Lists Avocado Desktop, the Avocado CLI and, on macOS, the Avocado VM, each with its state: up to date, an available update, or an error to retry. Check now checks all three. See Install and update.

Privacy & Help​

SettingWhat it does
Share analytics dataSends product usage data to Peridio. On by default. See the Privacy Policy.
Show getting started againBrings back the Getting started card on the Overview pane.
Replay welcome tourRuns the first-run wizard again.