claude_profile 1.2.0

Claude Code account credential management and token status
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56

# Parameter :: 53. `for::`

Specifies the target host+user identity for the `.account.assign` command as a single `USER@MACHINE` composite value. The command writes the active-account marker file for that identity instead of the current machine.

- **Default:** current machine's `$USER@resolve_hostname()` (same sources as `active_marker_filename()` — see [feature/025](../../feature/025_per_machine_active_marker.md))
- **Constraints:** When provided, must contain at least one `@`; both the user part (left of first `@`) and the machine part (right of first `@`) must be non-empty after splitting. Each component is sanitized: alphanumeric, `-`, `.` kept; all other characters become `_`.
- **Purpose:** Write the per-machine active-account marker for a target machine without being logged in there — enables pre-seeding account preferences in a shared or synced credential store.

**Value format:** `USER@MACHINE`

Split on the **first** `@`:
- Left of `@` → user component → sanitized → second segment of `_active_{machine}_{user}`
- Right of `@` → machine component → sanitized → first segment of `_active_{machine}_{user}`

The `@` separator mirrors SSH/remote convention (`user@host`) — unambiguous and familiar.

**Sanitization:** same char-filter as `active_marker_filename()`: alphanumeric, `-`, and `.` kept; all other characters become `_`.

**Examples:**

| `for::` value | Written filename |
|---------------|-----------------|
| `alice@laptop` | `_active_laptop_alice` |
| `user1@w003.local` | `_active_w003.local_user1` |
| `alice@my laptop` | `_active_my_laptop_alice` (space → `_`) |
| (omitted) | `_active_{hostname}_{user}` — current machine default |

**Usage:**

```bash
clp .account.assign name::work@corp.com for::alice@laptop
clp .account.assign name::work@corp.com for::user1@w003
clp .account.assign name::work@corp.com for::alice@laptop dry::1
```

**Error cases:**
- `for::badvalue` (no `@`) → exit 1 with message explaining `USER@MACHINE` format
- `for::@laptop` or `for::alice@` (empty component) → exit 1

**See Also:** [feature/032_account_assign.md](../../feature/032_account_assign.md) — full command semantics and execution steps.

### Referenced Type

- **Fundamental Type:** `string`

### Referenced Commands

| # | Command | Role |
|---|---------|------|
| 1 | [`.account.assign`](../command/001_account.md#command--16-accountassign) | Target machine identity for active-account marker |

### Referenced User Stories

| # | User Story | Persona |
|---|------------|---------|
| 1 | [Account Onboarding](../user_story/002_onboarding.md) | Pre-seed account preference for target machine |