# Settings

The Settings tab is where you configure your workspace. It is divided into these sub-tabs:

Sub-tab What you set there
General Appearance — including whether the Agents tab shows the terminal or the web view — backup and restore of the workspace, updates, restarting the box, and the agent server's version and health
Providers & Models The model a new session starts with, and additional model providers
MCP Servers The tools the agent is connected to, and tools you add yourself
Projects Your repositories, and the projects that check them out
Company The settings your company shares: agents, rules, skills and the repository catalog
Addons The read-only settings a service add-on has attached to your workspace
Cronjobs Prompts the workspace runs on a schedule, and the sessions they run in
Agents The agents available in the Agents tab, and your own versions of them
Credentials Git and SVN logins, model provider keys, access to PHOENIQS Cloud, personal environment variables and tool authorizations

# How settings combine

A setting can come from three places:

  1. Built-in defaults that every workspace starts with.
  2. The platform and your company settings. These are marked Managed by deployment in Settings and cannot be edited there.
  3. You, through the Settings sub-tabs.

For each individual setting, yours wins over your company's, and your company's wins over the built-in default. Where an entry is managed by the deployment, Settings offers a way to put your own in its place, such as Override for an agent or Re-authenticate for a credential.

# Where your settings are stored

Everything you set is stored under /workspace/.config, so it survives restarts and is part of Export settings on the General sub-tab.

Folder What it holds
.config/user Your agent settings: models, providers, tools and agents you added or changed
.config/company Your copy of the company settings
.config/workspace Your projects and repositories, and the encrypted store for credentials and personal environment variables
.config/code-server The IDE's settings

Use the Settings sub-tabs rather than editing these files by hand. Hand edits in .config/user do work, but saving from Settings rewrites the whole file, so never keep unsaved hand edits open at the same time.