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
57
58
59
60
61
62

# Verb :: save

Captures the current active session credentials as a named account profile in the credential store. Creates `{name}.credentials.json` and `{name}.json` under the per-machine store path, performing a read-merge on any pre-existing supplementary metadata.

### Nouns

| # | Noun | Command | Idempotent | Requires Session |
|---|------|---------|-----------|-----------------|
| 1 | [account](../command_noun/001_account.md) | `.account.save` | Conditional | Yes |

### Behavioral Contract

**Pre-conditions:**
- Active Claude Code session exists (`~/.claude/.credentials.json` readable and valid)
- `$HOME` environment variable set

**Post-conditions:**
- Named account profile exists in credential store (`{name}.credentials.json` + `{name}.json`)
- `{name}.json` supplementary fields merged from any pre-existing file (existing fields preserved)
- Active session credentials unchanged

**Side effects:**
- Writes two files per account: `{name}.credentials.json` (credential snapshot) and `{name}.json` (supplementary metadata)
- If `name::` resolves to an existing profile, existing `{name}.json` fields are preserved via read-merge (not overwritten)

### Idempotency

**Conditional.** Re-running `.account.save name::EMAIL` with the same credentials produces the same stored state. Running again after a credential change overwrites the credential snapshot but preserves unchanged supplementary metadata via read-merge. Not idempotent across credential changes.

### Common Parameters

| Parameter | Semantics | Required |
|-----------|-----------|----------|
| `name::` | Account name (email); defaults to email from active credentials | No |
| `host::` | Override store host label for multi-machine profiles | No |
| `role::` | Annotate account with a role label (e.g. `work`, `personal`) | No |
| `dry::` | Validate without writing files | No |
| `trace::` | Emit diagnostic trace output | No |

### State Transition Pattern

**Creates state.** Writes `{name}.credentials.json` (credential copy) and `{name}.json` (supplementary metadata) into the per-machine credential store. If the profile already exists, transitions its credential snapshot to the current session state.

```
[absent]  --account.save--> [saved]
[saved]   --account.save--> [saved]  (credential snapshot updated; {name}.json read-merged)
[active]  --account.save--> [active] (active account re-saved; no lifecycle change)
```

### Cross-References

| File | Relationship |
|------|-------------|
| [feature/001_account_store_init.md](../../feature/001_account_store_init.md) | Credential store initialization before first save |
| [feature/002_account_save.md](../../feature/002_account_save.md) | Save algorithm and `{name}.json` read-merge semantics |
| [feature/036_account_ownership.md](../../feature/036_account_ownership.md) | Ownership model — `.account.save` is ownership-neutral (passes `owner: None`); `.accounts unclaim::1` clears ownership; `.account.assign` is marker-only |

### Referenced Commands

| # | Command | Role |
|---|---------|------|
| 1 | [`.account.save`](../command/001_account.md#command--4-accountsave) | Capture current credentials as named profile |