# Settings

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

Phoeniqs AI Build: the Settings sub-tabs
Phoeniqs AI Build: the Settings sub-tabs

Sub-tab What you set there
General Theme and terminal font size, backup and restore of the workspace, 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
Agents The agents available in the Terminal, 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 Editor'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.