# Parameters
All `clp` CLI parameters with type, default, and command coverage.
| File | Responsibility |
|------|----------------|
| [001_name.md](001_name.md) | `name::` — target account identifier |
| [002_format.md](002_format.md) | `format::` / `fmt::` — output serialization format |
| [003_threshold.md](003_threshold.md) | `threshold::` — token expiry warning boundary |
| [004_dry.md](004_dry.md) | `dry::` — dry-run simulation mode |
| [005_account.md](005_account.md) | `account::` — account name field toggle |
| [006_sub.md](006_sub.md) | `sub::` — subscription type field toggle |
| [007_tier.md](007_tier.md) | `tier::` — rate-limit tier field toggle |
| [008_token.md](008_token.md) | `token::` — token status field toggle |
| [009_expires.md](009_expires.md) | `expires::` — token expiry field toggle |
| [010_email.md](010_email.md) | `email::` — email address field toggle |
| [011_file.md](011_file.md) | `file::` — credentials file path field toggle |
| [012_saved.md](012_saved.md) | `saved::` — saved account count field toggle |
| [013_active.md](013_active.md) | `active::` — active/inactive status field toggle |
| [014_display_name.md](014_display_name.md) | `display_name::` — display name field toggle |
| [015_role.md](015_role.md) | `role::` — organisation role field toggle |
| [016_billing.md](016_billing.md) | `billing::` — billing type field toggle |
| [017_model.md](017_model.md) | `model::` — active model field toggle |
| [018_current.md](018_current.md) | `current::` — current live account field toggle |
| [019_refresh.md](019_refresh.md) | `refresh::` — expired token refresh on auth error or locally-expired `expiresAt` |
| [020_live.md](020_live.md) | `live::` — continuous quota refresh loop |
| [021_interval.md](021_interval.md) | `interval::` — live mode cycle duration |
| [022_jitter.md](022_jitter.md) | `jitter::` — live mode cycle timing variance |
| [023_trace.md](023_trace.md) | `trace::` — diagnostic trace output to stderr |
| [024_field.md](024_field.md) | `field::` — single-path output selector |
| [025_sort.md](025_sort.md) | `sort::` — row ordering strategy for quota table |
| [026_desc.md](026_desc.md) | `desc::` — sort direction with context-sensitive default |
| [027_prefer.md](027_prefer.md) | `prefer::` — weekly quota column for sort heuristics |
| [028_uuid.md](028_uuid.md) | `uuid::` — stable user ID field toggle (opt-in) |
| [029_capabilities.md](029_capabilities.md) | `capabilities::` — product capabilities list toggle (opt-in) |
| [030_org_uuid.md](030_org_uuid.md) | `org_uuid::` — organisation UUID field toggle (opt-in) |
| [031_org_name.md](031_org_name.md) | `org_name::` — organisation display name field toggle (opt-in) |
| [032_next.md](032_next.md) | `next::` — REMOVED; recommendation driven by `sort::` |
| [033_cols.md](033_cols.md) | `cols::` — column visibility modifiers for quota table |
| [034_touch.md](034_touch.md) | `touch::` — activate idle accounts' 5h windows via isolated subprocess |
| [035_imodel.md](035_imodel.md) | `imodel::` — isolated subprocess model selection (`auto`, `sonnet`, `opus`, `haiku`, `keep`) |
| [036_effort.md](036_effort.md) | `effort::` — isolated subprocess effort level (`auto`, `low`, `normal`, `high`, `max`) |
| [037_count.md](037_count.md) | `count::` — maximum rows to display in quota table (0 = all) |
| [038_offset.md](038_offset.md) | `offset::` — skip first N rows from filtered result |
| [039_only_active.md](039_only_active.md) | `only_active::` — show only the active account row |
| [040_only_next.md](040_only_next.md) | `only_next::` — show only the recommended next account row |
| [041_min_5h.md](041_min_5h.md) | `min_5h::` — minimum 5h Left percentage threshold filter |
| [042_min_7d.md](042_min_7d.md) | `min_7d::` — minimum 7d Left percentage threshold filter |
| [043_only_valid.md](043_only_valid.md) | `only_valid::` — hide invalid-token (🔴) account rows |
| [044_exclude_exhausted.md](044_exclude_exhausted.md) | `exclude_exhausted::` — hide exhausted (🟡) and invalid (🔴) account rows |
| [045_get.md](045_get.md) | `get::` — single column value extraction for first filtered row |
| [046_abs.md](046_abs.md) | `abs::` — show absolute token counts instead of percentages |
| [047_no_color.md](047_no_color.md) | `no_color::` — strip emoji and ANSI colors from output |
| [048_host.md](048_host.md) | `host::` — host/machine label captured at account save time |
| [049_at.md](049_at.md) | `at::` — absolute ISO-8601 UTC renewal timestamp for `.account.renewal` |
| [050_from_now.md](050_from_now.md) | `from_now::` — signed duration delta from now for `.account.renewal` |
| [051_clear.md](051_clear.md) | `clear::` — remove billing renewal override from `{name}.json` |
| [052_role.md](052_role.md) | `role::` (metadata label) — free-text role label written to `{name}.json` at account save |
| [053_for.md](053_for.md) | `for::` — `USER@MACHINE` target identity for `.account.assign` |
| [054_set_model.md](054_set_model.md) | `set_model::` — explicit Claude Code session model write to `settings.json` |
| [055_set.md](055_set.md) | `set::` — model shorthand to write on `.model`; absent = get mode |
| [056_unclaim.md](056_unclaim.md) | `unclaim::` — **REMOVED** — superseded by `.account.unclaim` command (re-activated as mutation param on `.accounts`/`.usage` in Feature 037) |
| [057_assign.md](057_assign.md) | `assign::` — write per-machine active-account marker (mutation param on `.accounts`/`.usage`, Feature 037) |
| [058_force.md](058_force.md) | `force::` — bypass G5–G8 ownership enforcement on mutation commands |
| [059_rotate.md](059_rotate.md) | `rotate::` — after quota table render, switch to the footer-recommended account; mutually exclusive with `live::1`; G5 ownership gate; `dry::1` previews |
| [060_solo.md](060_solo.md) | `solo::` — token conservation mode restricting all credential-consuming operations to the current+owned account; others use `approximate_quota()` |
| [061_who.md](061_who.md) | `who::` — sessions table visibility in `.usage` (auto: shown when >1 active marker) |
**Total:** 60 active parameters (param 056 re-activated in Feature 037; 057–058 new; 059 new in Feature 038; 060 new; 061 new — sessions table)
### Overview Table
| # | Parameter | Type | Default | Valid Values | Purpose | Used In |
|---|-----------|------|---------|--------------|---------|---------|
| 1 | `name::` | `AccountName` | Varies | Email or prefix | Target account identifier | 8 cmds |
| 2 | `format::` / `fmt::` | `OutputFormat` | `text` | `text`, `json`, `table`; `value`/`tsv`/`plain` (.usage only) | Output format | 7 cmds |
| 3 | `threshold::` | `WarningThreshold` | `3600` | Non-negative integer (seconds) | Token expiry warning boundary | 1 cmd |
| 4 | `dry::` | `bool` | `0` | `0`, `1`, `false`, `true` | Dry-run simulation | 6 cmds |
| 5 | `account::` | `bool` | `1` | `0`, `1` | Account name line toggle | 1 cmd |
| 6 | `sub::` | `bool` | `1` | `0`, `1` | Subscription type line toggle | 2 cmds |
| 7 | `tier::` | `bool` | `1` | `0`, `1` | Rate-limit tier line toggle | 2 cmds |
| 8 | `token::` | `bool` | `1` | `0`, `1` | Token status line toggle | 1 cmd |
| 9 | `expires::` | `bool` | `1` | `0`, `1` | Token expiry line toggle | 2 cmds |
| 10 | `email::` | `bool` | `1` | `0`, `1` | Email address line toggle | 2 cmds |
| 11 | `file::` | `bool` | `0` | `0`, `1` | Credentials file path toggle (opt-in) | 1 cmd |
| 12 | `saved::` | `bool` | `0` | `0`, `1` | Saved account count toggle (opt-in) | 1 cmd |
| 13 | `active::` | `bool` | `1` | `0`, `1` | Active/inactive status toggle | 1 cmd |
| 14 | `display_name::` | `bool` | `0` | `0`, `1` | Display name toggle (opt-in) | 2 cmds |
| 15 | `role::` | `bool` | `0` | `0`, `1` | Organisation role toggle (opt-in) | 2 cmds |
| 16 | `billing::` | `bool` | `0` | `0`, `1` | Billing type toggle (opt-in) | 2 cmds |
| 17 | `model::` | `bool` | `0` | `0`, `1` | Active model toggle (opt-in) | 2 cmds |
| 18 | `current::` | `bool` | `1` | `0`, `1` | Current (live) account line toggle | 1 cmd |
| 19 | `refresh::` | `bool` | `1` | `0`, `1` | Refresh expired OAuth token; trigger is auth error or locally-expired `expiresAt` | 3 cmds |
| 20 | `live::` | `bool` | `0` | `0`, `1` | Continuous refresh loop | 1 cmd |
| 21 | `interval::` | `u64` | `30` | ≥ 30 (seconds) | Live mode cycle duration | 1 cmd |
| 22 | `jitter::` | `u64` | `0` | 0 ≤ jitter ≤ interval | Live mode cycle timing variance | 1 cmd |
| 23 | `trace::` | `bool` | `0` | `0`, `1` | Diagnostic trace output to stderr | 13 cmds |
| 24 | `field::` | `String` | `""` (show all) | `base`, `credentials`, `credential_store`, `projects`, `stats`, `settings`, `session_env`, `sessions` | Single-path output selector | 1 cmd |
| 25 | `sort::` | `enum` | `renew` | `name`, `renew`, `renews` | Row ordering strategy for quota table | 1 cmd |
| 26 | `desc::` | `bool` | context-sensitive | `0`, `1`, `false`, `true` | Sort direction; default per `sort::` strategy | 1 cmd |
| 27 | `prefer::` | `enum` | `any` | `any`, `opus`, `sonnet` | Weekly quota column for sort heuristics | 1 cmd |
| 28 | `uuid::` | `bool` | `0` | `0`, `1` | Stable user ID toggle (opt-in) | 2 cmds |
| 29 | `capabilities::` | `bool` | `0` | `0`, `1` | Product capabilities list toggle (opt-in) | 2 cmds |
| 30 | `org_uuid::` | `bool` | `0` | `0`, `1` | Organisation UUID toggle (opt-in) | 2 cmds |
| 31 | `org_name::` | `bool` | `0` | `0`, `1` | Organisation display name toggle (opt-in) | 2 cmds |
| 32 | `next::` | — | — | — | REMOVED — recommendation driven by `sort::` | — |
| 33 | `cols::` | `string` | `""` | `+col_id`, `-col_id` modifiers | Column visibility modifiers | 1 cmd |
| 34 | `touch::` | `bool` | `1` | `0`, `1`, `false`, `true` | Activate idle accounts' 5h windows | 2 cmds |
| 35 | `imodel::` | `enum` | `auto` | `auto`, `sonnet`, `opus`, `haiku`, `keep` | Isolated subprocess model selection | 2 cmds |
| 36 | `effort::` | `enum` | `auto` | `auto`, `low`, `normal`, `high`, `max` | Isolated subprocess effort level | 2 cmds |
| 37 | `count::` | `u64` | `0` | Non-negative integer | Max rows to display (0 = all) | 1 cmd |
| 38 | `offset::` | `u64` | `0` | Non-negative integer | Skip first N rows from result | 1 cmd |
| 39 | `only_active::` | `bool` | `0` | `0`, `1` | Show only active account row | 1 cmd |
| 40 | `only_next::` | `bool` | `0` | `0`, `1` | Show only the recommended account row | 1 cmd |
| 41 | `min_5h::` | `f64` | `0` | `0`–`100` | Minimum 5h Left % filter | 1 cmd |
| 42 | `min_7d::` | `f64` | `0` | `0`–`100` | Minimum 7d Left % filter | 1 cmd |
| 43 | `only_valid::` | `bool` | `0` | `0`, `1` | Hide 🔴 invalid-token rows | 1 cmd |
| 44 | `exclude_exhausted::` | `bool` | `0` | `0`, `1` | Hide 🟡 and 🔴 rows | 1 cmd |
| 45 | `get::` | `string` | `""` | Field IDs (see 045_get.md) | Single column value extraction | 1 cmd |
| 46 | `abs::` | `bool` | `0` | `0`, `1` | Absolute token counts instead of % | 1 cmd |
| 47 | `no_color::` | `bool` | `0` | `0`, `1` | Strip emoji and ANSI from output | 1 cmd |
| 48 | `host::` | `string` | `""` (auto) | Any string | Machine/host label at save; display toggle at list | 2 cmds |
| 49 | `at::` | `string` | *(omit)* | ISO-8601 UTC datetime | Absolute renewal timestamp for `.account.renewal` | 1 cmd |
| 50 | `from_now::` | `string` | *(omit)* | `+`/`-` duration (e.g., `+3h30m`) | Signed delta from now for `.account.renewal` | 1 cmd |
| 51 | `clear::` | `bool` | `0` | `0`, `1` | Remove billing renewal override | 1 cmd |
| 52 | `role::` (metadata label) | `string` | `""` | Any string | User-defined role label at account save | 1 cmd |
| 53 | `for::` | `string` | `$USER@resolve_hostname()` | `USER@MACHINE` | Target host+user identity for `.account.assign` | 1 cmd |
| 54 | `set_model::` | `enum` | *(omit)* | `opus`, `sonnet`, `haiku`, `default` | Explicit session model write to `settings.json` | 2 cmds |
| 55 | `set::` | `enum` | *(omit)* | `opus`, `sonnet`, `haiku`, `default` | Mode selector on `.model`: absent = get, present = set | 1 cmd |
| 56 | `unclaim::` | `bool` | `0` | `0`, `1` | Release ownership of named account (mutation param on `.accounts`/`.usage`; Feature 037) | `.accounts`, `.usage` |
| 57 | `assign::` | `bool` | `0` | `0`, `1` | Write per-machine active-account marker (mutation param on `.accounts`/`.usage`; Feature 037) | `.accounts`, `.usage` |
| 58 | `force::` | `bool` | `0` | `0`, `1`, `false`, `true` | Bypass G5–G8 ownership enforcement on mutation commands | `.account.use`, `.account.delete`, `.account.relogin`, `.accounts`, `.usage` |
| 59 | `rotate::` | `bool` | `0` | `0`, `1` | After quota table render, switch to footer-recommended account; mutually exclusive with `live::1`; G5 ownership gate | `.usage` |
| 60 | `solo::` | `bool` | `0` | `0`, `1` | Token conservation: restrict all credential-consuming operations to current+owned account; others use `approximate_quota()` | `.usage` |
| 61 | `who::` | `i64` | `-1` | `-1` (auto), `0` (hide), `1` (show) | Sessions table visibility in `.usage` output | `.usage` |
*Param 1 = cross-command account selector (no formal group); params 48, 52 = Group 006 Account Targeting; params 49–51 = ungrouped (`.account.renewal`-specific); param 53 = ungrouped (`.account.assign`-specific); param 55 = ungrouped (`.model`-specific); param 56 = REMOVED; param 2 = Output Control group; params 5–18, 28–31 = Field Presence group; params 19–23, 34–36, 54, 60 = Fetch Behavior group; param 24 = ungrouped; params 25–27, 32 = Sort Control group; params 33, 37–47 = Display Control group (contains both display-toggle params and pipeline-coupled request-constraint row filters — see Pipeline Stage attribute in each param file)*
### See Also
- [../type/](../type/readme.md) — types used by parameters
- [../command/](../command/readme.md) — commands that accept these parameters
- [../param_group/](../param_group/readme.md) — parameter group definitions
- [../user_story/](../user_story/readme.md) — user stories that reference these parameters
- [../command_noun/](../command_noun/readme.md) — domain nouns whose commands accept these parameters
- [../command_verb/](../command_verb/readme.md) — domain verbs that list common parameters