> ## 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.

# Accounts Workspace

> Manage CCS auth profiles, continuity groups, and Claude pool handoff from the dashboard

# Accounts Workspace

The Accounts workspace at `/accounts` is the dashboard surface for **CCS auth
profiles**. Use it when you manage `ccs auth` profiles, continuity groups, and
default-account behavior. Use the Claude provider inside `/cliproxy` instead
when the account should live in the CLIProxy pool.

## Access

```bash theme={null}
ccs config
# Sidebar -> Identity & Access -> Accounts
# Direct route -> /accounts
```

## What It Covers

* create new CCS auth profiles without leaving the dashboard
* follow the recommended two-account route: keep tokens isolated and choose
  the account explicitly at runtime
* inspect continuity and context-group relationships
* see when plain `ccs` is using a different resume lane than an account profile
* review migration follow-up for legacy inferred sharing
* jump into the Claude pool auth flow when an account belongs in CLIProxy

## Layout

### Left Action Rail

The left rail is the command surface for day-to-day account work:

* **Create Account** opens the profile creation dialog
* **Auth Claude In Pool** deep-links into `/cliproxy?provider=claude&action=auth`
* **Open Claude Pool Settings** jumps to the Claude provider inside `/cliproxy`
* **Migration Follow-up** appears when legacy inferred sharing still needs confirmation
* **Quick Commands** mirrors the most common CLI flows with copy buttons

### Main Workspace

The main panel is a continuity-first view of your auth profiles:

* **Continuity overview** summarizes isolated lanes, shared lanes, deeper-continuity readiness, and CLIProxy-adjacent counts
* **Route guide** explains isolated account usage, shared `settings.json`, and opt-in history sync
* **Account matrix** lists CCS auth profiles, default-account state, and group relationships
* **Badges** call out the workspace scope and history-sync posture before you edit anything

The workspace separates three concepts that are easy to confuse:

| Concept                             | Default                              | How to inspect                           |
| ----------------------------------- | ------------------------------------ | ---------------------------------------- |
| Credentials and tokens              | isolated per account profile         | `ccs auth show <profile>`                |
| Basic `settings.json`               | shared for non-bare account profiles | route guide or `ccs auth show <profile>` |
| Local history and resume continuity | isolated unless sharing is enabled   | continuity overview and account matrix   |

Non-bare account profiles link basic settings through CCS shared state:

```text theme={null}
~/.ccs/instances/<profile>/settings.json
  -> ~/.ccs/shared/settings.json
  -> ~/.claude/settings.json
```

This keeps normal Claude settings aligned without copying account credentials.
History sync is separate and remains opt-in.

### Mobile View

On smaller screens the workspace collapses into a stacked layout. The same
actions remain available, but the side rail becomes a compact card above the
account matrix.

## Relationship To Shared Data

`/accounts` and `/shared` live in the same sidebar group, but they solve
different problems:

| Route       | Use it for                                                      |
| ----------- | --------------------------------------------------------------- |
| `/accounts` | CCS auth profiles, continuity, default-account management       |
| `/shared`   | shared commands, skills, and agents under the Claude asset tree |

If you need to inspect or repair shared commands, skills, or agents, switch to
the dedicated [Shared Data](/features/config/shared-data) workspace instead of
editing auth profiles here.

## CLI Parity

The workspace stays aligned with the CLI rather than replacing it:

```bash theme={null}
ccs auth create work
ccs auth create personal
ccs work
ccs personal

ccs auth create work --share-context --context-group sprint-a --deeper-continuity
ccs auth show work
ccs auth backup default
ccs auth default work
ccs cliproxy auth claude
```

Use the dashboard when you want structure and visibility. Use the CLI when you
need scripts, terminals, or versioned setup.

## Related

* [Claude Accounts](/providers/concepts/claude-accounts)
* [CLIProxy API](/features/proxy/cliproxy-api)
* [Shared Data](/features/config/shared-data)
