> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ccs.kaitran.ca/llms.txt
> Use this file to discover all available pages before exploring further.

# Settings Workspace

> The split-view settings workspace for WebSearch, image analysis, channels, proxy, auth, and backups

# Settings Workspace

The Settings workspace at `/settings` is the dashboard's routed configuration
surface. On desktop it uses a **split view**: form-based controls on the left,
a live read-only snapshot of `~/.ccs/config.yaml` on the right.

## Access

```bash theme={null}
ccs config
# Sidebar -> System -> Settings
# Direct route -> /settings
```

## Current Layout

### Desktop

* **Left panel**: tabbed configuration sections
* **Right panel**: `config.yaml` viewer with copy and refresh actions
* **Resize handle**: lets you rebalance forms vs raw config

### Mobile

The page collapses into a stacked layout. The raw `config.yaml` viewer drops
behind the active section so the forms stay usable on narrow screens.

## Current Tabs

| Tab         | What it manages                                                         | Related doc                                                 |
| ----------- | ----------------------------------------------------------------------- | ----------------------------------------------------------- |
| `WebSearch` | provider readiness, API keys, install hints, and CCS search routing     | [WebSearch](/features/ai/websearch)                         |
| `Image`     | MCP-first image analysis state, repair actions, and profile coverage    | [Image Analysis](/features/ai/image-analysis)               |
| `Channels`  | official-channel selection, token status, and launch preview            | [CLI Commands](/reference/cli-commands)                     |
| `Env`       | top-level global environment variables saved in CCS config              | [Configuration](/getting-started/configuration)             |
| `Thinking`  | thinking mode, overrides, tier defaults, and provider overrides         | [Extended Thinking](/features/ai/extended-thinking)         |
| `Browser`   | Claude Browser Attach and Codex Browser Tools setup, status, and policy | [Browser Automation](/features/workflow/browser-automation) |
| `Proxy`     | local vs remote CLIProxy server settings and connectivity               | [Remote Proxy](/features/proxy/remote-proxy)                |
| `Auth`      | dashboard authentication enablement, secret generation, and status      | [Dashboard Authentication](/features/dashboard/auth)        |
| `Backups`   | backup inventory, restore, and cleanup workflows                        | [File Locations](/reference/file-locations)                 |

## Raw Config Pane

The right-hand pane is a **viewer**, not a second editor:

* shows the current `~/.ccs/config.yaml`
* supports copy and refresh actions
* helps you verify what the forms actually persisted

If the file does not exist yet, the workspace points you back to:

```bash theme={null}
ccs migrate
```

## Operational Notes

* Section content is lazy-loaded, so the active tab can recover independently if one section fails
* Structured settings stay in the form controls; raw YAML remains read-only in this workspace
* The page is route-aware, so you can bookmark `/settings` directly inside the current dashboard session

## When To Use This Page

Use the Settings workspace when the change belongs to **shared CCS behavior**:

* search and image-analysis tooling
* announcement and support channels
* global env defaults
* proxy topology
* browser automation exposure policy
* dashboard auth
* backup hygiene

Use the profile workspaces instead when the change is specific to **one
provider or one compatible CLI**.

## Related

* [Dashboard Overview](/features/dashboard/overview)
* [WebSearch](/features/ai/websearch)
* [Image Analysis](/features/ai/image-analysis)
* [Remote Proxy](/features/proxy/remote-proxy)