@narumitw/pi-starship 0.60.1 → 0.62.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +63 -6
- package/dist/chunks/chunk-43VIENBN.ts +1586 -0
- package/dist/chunks/chunk-43VIENBN.ts.map +7 -0
- package/dist/chunks/chunk-HPZTMIZS.ts +646 -0
- package/dist/chunks/chunk-HPZTMIZS.ts.map +7 -0
- package/dist/chunks/chunk-IYDZ3R2T.ts +69 -0
- package/dist/chunks/chunk-IYDZ3R2T.ts.map +7 -0
- package/dist/chunks/chunk-KP33I6BR.ts +579 -0
- package/dist/chunks/chunk-KP33I6BR.ts.map +7 -0
- package/dist/chunks/{chunk-KZZKGGFW.ts → chunk-PWTSHSP3.ts} +853 -1001
- package/dist/chunks/chunk-PWTSHSP3.ts.map +7 -0
- package/dist/chunks/{chunk-PD457PX5.ts → chunk-S2KBLHE2.ts} +75 -10
- package/dist/chunks/chunk-S2KBLHE2.ts.map +7 -0
- package/dist/chunks/chunk-XQUIQO2G.ts +20 -0
- package/dist/chunks/chunk-XQUIQO2G.ts.map +7 -0
- package/dist/chunks/{chunk-ADX4CY27.ts → chunk-XTLQ4WUL.ts} +1 -1
- package/dist/chunks/chunk-XTLQ4WUL.ts.map +7 -0
- package/dist/chunks/{cloud-EPAEV4ZB.ts → cloud-J2ZOE3HE.ts} +6 -2
- package/dist/chunks/cloud-J2ZOE3HE.ts.map +7 -0
- package/dist/chunks/command-configuration-menu-S2LXCOJG.ts +147 -0
- package/dist/chunks/command-configuration-menu-S2LXCOJG.ts.map +7 -0
- package/dist/chunks/command-settings-chat-O34BEU4X.ts +1041 -0
- package/dist/chunks/command-settings-chat-O34BEU4X.ts.map +7 -0
- package/dist/chunks/commands-ZYIJVIEJ.ts +1022 -0
- package/dist/chunks/commands-ZYIJVIEJ.ts.map +7 -0
- package/dist/chunks/{deployment-7J54EHNR.ts → deployment-NOJ2KCLI.ts} +85 -5
- package/dist/chunks/deployment-NOJ2KCLI.ts.map +7 -0
- package/dist/chunks/{development-IWJAAAEV.ts → development-T3XXVVDP.ts} +67 -15
- package/dist/chunks/development-T3XXVVDP.ts.map +7 -0
- package/dist/chunks/directory-OX6BWJZA.ts +31 -0
- package/dist/chunks/directory-OX6BWJZA.ts.map +7 -0
- package/dist/chunks/{execution-P4WZALW2.ts → execution-R2OHIP2L.ts} +8 -4
- package/dist/chunks/execution-R2OHIP2L.ts.map +7 -0
- package/dist/chunks/jujutsu-XLDYKSX2.ts +174 -0
- package/dist/chunks/jujutsu-XLDYKSX2.ts.map +7 -0
- package/dist/chunks/languages-CBQNNYXM.ts +262 -0
- package/dist/chunks/languages-CBQNNYXM.ts.map +7 -0
- package/dist/chunks/{package-H24VJEX3.ts → package-7KVAK3TC.ts} +6 -2
- package/dist/chunks/package-7KVAK3TC.ts.map +7 -0
- package/dist/chunks/system-574MHB4R.ts +165 -0
- package/dist/chunks/system-574MHB4R.ts.map +7 -0
- package/dist/index.ts +558 -150
- package/dist/index.ts.map +4 -4
- package/package.json +5 -1
- package/skills/configure-pi-starship/SKILL.md +14 -0
- package/skills/configure-pi-starship/references/configuration.md +109 -24
- package/skills/configure-pi-starship/references/module-catalog.md +278 -25
- package/skills/configure-pi-starship/references/modules.md +213 -36
- package/skills/configure-pi-starship/references/runtime-and-security.md +88 -28
- package/src/command-configuration-menu.ts +155 -0
- package/src/command-configuration.ts +9 -84
- package/src/command-preview.ts +3 -3
- package/src/command-settings-chat.ts +210 -0
- package/src/commands.ts +54 -98
- package/src/config/module-options.ts +112 -0
- package/src/config.ts +17 -53
- package/src/effective-config.ts +5 -4
- package/src/format/bounded-regex.ts +66 -0
- package/src/format/version.ts +24 -0
- package/src/modules/catalog.ts +10 -0
- package/src/modules/cloud.ts +1 -0
- package/src/modules/deployment.ts +8 -0
- package/src/modules/development.ts +20 -2
- package/src/modules/directory.ts +171 -51
- package/src/modules/execution.ts +2 -0
- package/src/modules/git/branch.ts +19 -4
- package/src/modules/git/commit.ts +9 -2
- package/src/modules/git/metrics.ts +9 -4
- package/src/modules/git/runtime.ts +122 -33
- package/src/modules/git/state.ts +23 -2
- package/src/modules/git/status-templates.ts +58 -0
- package/src/modules/git/status.ts +96 -30
- package/src/modules/jujutsu.ts +225 -0
- package/src/modules/languages.ts +26 -2
- package/src/modules/package.ts +1 -0
- package/src/modules/render.ts +42 -16
- package/src/modules/system.ts +54 -0
- package/src/modules/time-format.ts +188 -0
- package/src/modules/time.ts +11 -5
- package/src/modules/types.ts +42 -4
- package/src/pi-starship.ts +56 -12
- package/src/profile-store.ts +5 -0
- package/src/runtime/cloud.ts +3 -0
- package/src/runtime/command.ts +1 -1
- package/src/runtime/deployment.ts +120 -4
- package/src/runtime/development.ts +86 -13
- package/src/runtime/directory.ts +33 -0
- package/src/runtime/execution.ts +12 -2
- package/src/runtime/helpers.ts +57 -8
- package/src/runtime/jujutsu.ts +225 -0
- package/src/runtime/languages.ts +106 -19
- package/src/runtime/package.ts +3 -0
- package/src/runtime/system.ts +202 -0
- package/src/runtime/types.ts +3 -0
- package/src/runtime/version-requirements.ts +30 -0
- package/src/runtime/workspace.ts +12 -1
- package/src/settings-agent.ts +80 -0
- package/src/settings-chat-transcript.ts +140 -0
- package/src/settings-chat-ui.ts +426 -0
- package/src/settings-draft.ts +260 -0
- package/src/settings-snapshots.ts +41 -0
- package/dist/chunks/chunk-ADX4CY27.ts.map +0 -7
- package/dist/chunks/chunk-KZZKGGFW.ts.map +0 -7
- package/dist/chunks/chunk-PD457PX5.ts.map +0 -7
- package/dist/chunks/cloud-EPAEV4ZB.ts.map +0 -7
- package/dist/chunks/commands-C2VJ6ZBN.ts +0 -3374
- package/dist/chunks/commands-C2VJ6ZBN.ts.map +0 -7
- package/dist/chunks/deployment-7J54EHNR.ts.map +0 -7
- package/dist/chunks/development-IWJAAAEV.ts.map +0 -7
- package/dist/chunks/execution-P4WZALW2.ts.map +0 -7
- package/dist/chunks/languages-JO6R2PHL.ts +0 -168
- package/dist/chunks/languages-JO6R2PHL.ts.map +0 -7
- package/dist/chunks/package-H24VJEX3.ts.map +0 -7
- package/src/command-inspector.ts +0 -41
|
@@ -22,12 +22,12 @@ A wrong type or out-of-range option warns and uses that field's default.
|
|
|
22
22
|
|
|
23
23
|
String maps require string values.
|
|
24
24
|
String arrays require non-empty strings.
|
|
25
|
-
|
|
25
|
+
Detection arrays document whether they allow a leading `!` rejection rule. Command, context-rule, and substitution arrays use the bounded shapes documented below.
|
|
26
26
|
All enum values are case-sensitive.
|
|
27
27
|
|
|
28
28
|
## Catalog order
|
|
29
29
|
|
|
30
|
-
`brand` → `provider` → `model` → `thinking` → `directory` → `git_worktree` → `git_branch` → `github_pr` → `git_commit` → `git_state` → `git_metrics` → `git_status` → `package` → `nodejs` → `python` → `rust` → `golang` → `bun` → `deno` → `mise` → `direnv` → `conda` → `pixi` → `nix_shell` → `guix_shell` → `docker_context` → `kubernetes` → `terraform` → `aws` → `gcloud` → `azure` → `openstack` → `os` → `container` → `hostname` → `username` → `activity` → `context` → `tokens` → `cache` → `cost` → `time` → `turn` → `fill` → `extension_status`
|
|
30
|
+
`brand` → `provider` → `model` → `thinking` → `directory` → `git_worktree` → `git_branch` → `github_pr` → `git_commit` → `git_state` → `git_metrics` → `git_status` → `jj_bookmark` → `jj_change` → `jj_metrics` → `jj_status` → `package` → `nodejs` → `python` → `rust` → `golang` → `bun` → `deno` → `mise` → `direnv` → `conda` → `pixi` → `nix_shell` → `guix_shell` → `docker_context` → `kubernetes` → `terraform` → `aws` → `gcloud` → `azure` → `openstack` → `os` → `container` → `hostname` → `username` → `memory_usage` → `battery` → `activity` → `context` → `tokens` → `cache` → `cost` → `time` → `turn` → `fill` → `extension_status`
|
|
31
31
|
|
|
32
32
|
## Module schemas
|
|
33
33
|
|
|
@@ -65,9 +65,9 @@ Accepted style fields:
|
|
|
65
65
|
|
|
66
66
|
Accepted style-rule selectors (`style_rules` default: `[]`):
|
|
67
67
|
|
|
68
|
-
| Selector |
|
|
68
|
+
| Selector | Matches |
|
|
69
69
|
| --- | --- |
|
|
70
|
-
| `provider` |
|
|
70
|
+
| `provider` | Exact raw runtime provider. |
|
|
71
71
|
|
|
72
72
|
Additional options:
|
|
73
73
|
|
|
@@ -93,19 +93,19 @@ Accepted style fields:
|
|
|
93
93
|
|
|
94
94
|
Accepted style-rule selectors (`style_rules` default: `[]`):
|
|
95
95
|
|
|
96
|
-
| Selector |
|
|
96
|
+
| Selector | Matches |
|
|
97
97
|
| --- | --- |
|
|
98
|
-
| `provider` |
|
|
99
|
-
| `model` |
|
|
98
|
+
| `provider` | Exact raw runtime provider. |
|
|
99
|
+
| `model` | Exact raw runtime model. |
|
|
100
100
|
|
|
101
101
|
Additional options:
|
|
102
102
|
|
|
103
103
|
| Option | Type | Default | Constraints and meaning |
|
|
104
104
|
| --- | --- | --- | --- |
|
|
105
105
|
| `shorten_model` | boolean | `false` | Opt in to removing a leading `claude-`, a trailing `-20` plus six digits, or a trailing `-latest` from model IDs that do not match an alias; `gpt-` is unchanged. |
|
|
106
|
-
| `truncation_length` | integer | `0` | Inclusive range 0 through 1000. Maximum retained model-label grapheme clusters; zero disables truncation. |
|
|
106
|
+
| `truncation_length` | integer | `0` | Inclusive range 0 through 1000. Inclusive range 0 through 1000. Maximum retained model-label grapheme clusters; zero disables truncation. |
|
|
107
107
|
| `truncation_symbol` | string | `"…"` | May be empty. Marker placed at the removed start, middle, or end; an empty string removes text without a marker. |
|
|
108
|
-
| `truncation_direction` | string enum | `"end"` | One of `start`, `middle`, `end`. Which part of the model label is removed when truncating. |
|
|
108
|
+
| `truncation_direction` | string enum | `"end"` | One of `start`, `middle`, `end`. One of `start`, `middle`, `end`. Which part of the model label is removed when truncating. |
|
|
109
109
|
| `model_aliases` | string-to-string table | `{}` | Keys and values are strings. Exact model-ID replacements that bypass optional shortening and are then subject to configured truncation. |
|
|
110
110
|
|
|
111
111
|
### `thinking`
|
|
@@ -133,17 +133,17 @@ Accepted style fields:
|
|
|
133
133
|
|
|
134
134
|
Accepted style-rule selectors (`style_rules` default: `[]`):
|
|
135
135
|
|
|
136
|
-
| Selector |
|
|
136
|
+
| Selector | Matches |
|
|
137
137
|
| --- | --- |
|
|
138
|
-
| `provider` |
|
|
139
|
-
| `level` |
|
|
138
|
+
| `provider` | Exact raw runtime provider. |
|
|
139
|
+
| `level` | Exact raw runtime level. |
|
|
140
140
|
|
|
141
141
|
### `directory`
|
|
142
142
|
|
|
143
143
|
Current working directory.
|
|
144
144
|
|
|
145
|
-
- Format variables: `$symbol`, `$path`, `$full_path`.
|
|
146
|
-
- Style variables in `format`: `$style`.
|
|
145
|
+
- Format variables: `$symbol`, `$path`, `$full_path`, `$before_root_path`, `$repo_root`, `$read_only`.
|
|
146
|
+
- Style variables in `format`: `$style`, `$repo_root_style`, `$before_repo_root_style`, `$read_only_style`.
|
|
147
147
|
- Default `format`: `"[ $symbol $path ]($style)"`.
|
|
148
148
|
- Default `symbol`: `"📁"`.
|
|
149
149
|
- Default `disabled`: `false`.
|
|
@@ -153,18 +153,24 @@ Accepted style fields:
|
|
|
153
153
|
| Field | Default |
|
|
154
154
|
| --- | --- |
|
|
155
155
|
| `style` | `"cyan bold"` |
|
|
156
|
+
| `repo_root_style` | `""` |
|
|
157
|
+
| `before_repo_root_style` | `""` |
|
|
158
|
+
| `read_only_style` | `"red"` |
|
|
156
159
|
|
|
157
160
|
Additional options:
|
|
158
161
|
|
|
159
162
|
| Option | Type | Default | Constraints and meaning |
|
|
160
163
|
| --- | --- | --- | --- |
|
|
161
|
-
| `truncation_length` | integer | `3` | Inclusive range 0 through 1000000. Number of trailing path components retained; zero keeps every component. |
|
|
164
|
+
| `truncation_length` | integer | `3` | Inclusive range 0 through 1000000. Inclusive range 0 through 1000000. Number of trailing path components retained; zero keeps every component. |
|
|
162
165
|
| `truncate_to_repo` | boolean | `true` | Contracts the displayed path relative to the current Git repository root before component truncation. |
|
|
163
|
-
| `fish_style_pwd_dir_length` | integer | `0` | Inclusive range 0 through 1000. Abbreviates otherwise omitted parent components to this many grapheme clusters when no substitution is configured. |
|
|
166
|
+
| `fish_style_pwd_dir_length` | integer | `0` | Inclusive range 0 through 1000. Inclusive range 0 through 1000. Abbreviates otherwise omitted parent components to this many grapheme clusters when no substitution is configured. |
|
|
164
167
|
| `truncation_symbol` | string | `""` | May be empty. Prefix placed before a contracted or component-truncated path when fish-style abbreviation is inactive. |
|
|
165
168
|
| `home_symbol` | string | `"~"` | May be empty. Replacement for the current user's home-directory prefix. |
|
|
166
169
|
| `use_os_path_sep` | boolean | `true` | Uses the platform path separator instead of always rendering `/`. |
|
|
167
|
-
| `
|
|
170
|
+
| `use_logical_path` | boolean | `true` | Use Pi's current path when true; false uses cached realpath, falling back to the current path when unavailable. |
|
|
171
|
+
| `repo_root_format` | string | `""` | Alternate root-aware format. Empty inherits the normal format unless repo_root_style selects the split fallback; used only when the root remains visible. |
|
|
172
|
+
| `read_only` | string | `"🔒"` | Indicator supplied as $read_only only when a requested cached W_OK probe reports read-only. Empty disables the probe. |
|
|
173
|
+
| `substitutions` | substitution table or array | `{}` | Ordered literal replacements applied to the home- or repository-contracted display path before component truncation; also accepts from/to/regex rows with bounded RE2 matching. |
|
|
168
174
|
|
|
169
175
|
### `git_worktree`
|
|
170
176
|
|
|
@@ -202,8 +208,13 @@ Additional options:
|
|
|
202
208
|
|
|
203
209
|
| Option | Type | Default | Constraints and meaning |
|
|
204
210
|
| --- | --- | --- | --- |
|
|
205
|
-
| `truncation_length` | integer | `0` | Inclusive range 0 through 1000000. Grapheme clusters retained independently for branch and remote labels; zero disables truncation. |
|
|
211
|
+
| `truncation_length` | integer | `0` | Inclusive range 0 through 1000000. Inclusive range 0 through 1000000. Grapheme clusters retained independently for branch and remote labels; zero disables truncation. |
|
|
206
212
|
| `truncation_symbol` | string | `"…"` | May be empty. Its first grapheme is appended to each truncated branch or remote label. |
|
|
213
|
+
| `only_attached` | boolean | `false` | Hide the branch when HEAD is detached. |
|
|
214
|
+
| `always_show_remote` | boolean | `true` | Keep equal branch/remote labels when true (Pi default); false hides the matching remote branch after truncation. |
|
|
215
|
+
| `ignore_branches` | string array | `[]` | Exact branch names to hide. |
|
|
216
|
+
| `ignore_remotes` | string array | `[]` | Exact remote names to hide; does not hide the remote branch. |
|
|
217
|
+
| `ignore_bare_repo` | boolean | `true` | Hide bare repositories by default; false permits bounded bare-repository detection. |
|
|
207
218
|
|
|
208
219
|
### `github_pr`
|
|
209
220
|
|
|
@@ -241,7 +252,11 @@ Additional options:
|
|
|
241
252
|
|
|
242
253
|
| Option | Type | Default | Constraints and meaning |
|
|
243
254
|
| --- | --- | --- | --- |
|
|
244
|
-
| `commit_hash_length` | integer | `7` | Inclusive range 0 through 64. Maximum commit-hash characters retained from the collected HEAD hash. |
|
|
255
|
+
| `commit_hash_length` | integer | `7` | Inclusive range 0 through 64. Inclusive range 0 through 64. Maximum commit-hash characters retained from the collected HEAD hash. |
|
|
256
|
+
| `only_detached` | boolean | `false` | Show the commit only while HEAD is detached. |
|
|
257
|
+
| `tag_symbol` | string | `" 🏷 "` | Prefix included in the rendered $tag value. |
|
|
258
|
+
| `tag_disabled` | boolean | `false` | Do not collect or display a tag. |
|
|
259
|
+
| `tag_max_candidates` | integer | `0` | Inclusive range 0 through 100. Zero preserves exact HEAD-tag lookup; positive values permit first-parent tag discovery with this candidate limit. |
|
|
245
260
|
|
|
246
261
|
### `git_state`
|
|
247
262
|
|
|
@@ -259,6 +274,18 @@ Accepted style fields:
|
|
|
259
274
|
| --- | --- |
|
|
260
275
|
| `style` | `"bold yellow"` |
|
|
261
276
|
|
|
277
|
+
Additional options:
|
|
278
|
+
|
|
279
|
+
| Option | Type | Default | Constraints and meaning |
|
|
280
|
+
| --- | --- | --- | --- |
|
|
281
|
+
| `rebase` | string | `"REBASING"` | Replacement label for the rebase operation. |
|
|
282
|
+
| `merge` | string | `"MERGING"` | Replacement label for the merge operation. |
|
|
283
|
+
| `revert` | string | `"REVERTING"` | Replacement label for the revert operation. |
|
|
284
|
+
| `cherry_pick` | string | `"CHERRY-PICKING"` | Replacement label for the cherry pick operation. |
|
|
285
|
+
| `bisect` | string | `"BISECTING"` | Replacement label for the bisect operation. |
|
|
286
|
+
| `am` | string | `"AM"` | Replacement label for the am operation. |
|
|
287
|
+
| `am_or_rebase` | string | `"AM/REBASE"` | Replacement label for the am or rebase operation. |
|
|
288
|
+
|
|
262
289
|
### `git_metrics`
|
|
263
290
|
|
|
264
291
|
Added and deleted lines in the current Git worktree.
|
|
@@ -276,6 +303,13 @@ Accepted style fields:
|
|
|
276
303
|
| `added_style` | `"bold green"` |
|
|
277
304
|
| `deleted_style` | `"bold red"` |
|
|
278
305
|
|
|
306
|
+
Additional options:
|
|
307
|
+
|
|
308
|
+
| Option | Type | Default | Constraints and meaning |
|
|
309
|
+
| --- | --- | --- | --- |
|
|
310
|
+
| `only_nonzero_diffs` | boolean | `true` | Hide zero added/deleted values when true. |
|
|
311
|
+
| `ignore_submodules` | boolean | `false` | Ignore submodule diffs and disable external diff/textconv for that query. |
|
|
312
|
+
|
|
279
313
|
### `git_status`
|
|
280
314
|
|
|
281
315
|
Current Git worktree and index status summary.
|
|
@@ -292,6 +326,137 @@ Accepted style fields:
|
|
|
292
326
|
| --- | --- |
|
|
293
327
|
| `style` | `"red bold"` |
|
|
294
328
|
|
|
329
|
+
Additional options:
|
|
330
|
+
|
|
331
|
+
| Option | Type | Default | Constraints and meaning |
|
|
332
|
+
| --- | --- | --- | --- |
|
|
333
|
+
| `ahead` | string | `"⇡$count"` | Bounded formatter template (4096 characters, 16 nested groups); variables: `$count`. |
|
|
334
|
+
| `behind` | string | `"⇣$count"` | Bounded formatter template (4096 characters, 16 nested groups); variables: `$count`. |
|
|
335
|
+
| `up_to_date` | string | `""` | Bounded formatter template (4096 characters, 16 nested groups); no content variables. |
|
|
336
|
+
| `diverged` | string | `"⇕⇡$ahead_count⇣$behind_count"` | Bounded formatter template (4096 characters, 16 nested groups); variables: `$ahead_count`, `$behind_count`. |
|
|
337
|
+
| `conflicted` | string | `"=$count"` | Bounded formatter template (4096 characters, 16 nested groups); variables: `$count`. |
|
|
338
|
+
| `stashed` | string | `"\\$$count"` | Bounded formatter template (4096 characters, 16 nested groups); variables: `$count`. |
|
|
339
|
+
| `deleted` | string | `"✘$count"` | Bounded formatter template (4096 characters, 16 nested groups); variables: `$count`. |
|
|
340
|
+
| `renamed` | string | `"»$count"` | Bounded formatter template (4096 characters, 16 nested groups); variables: `$count`. |
|
|
341
|
+
| `modified` | string | `"!$count"` | Bounded formatter template (4096 characters, 16 nested groups); variables: `$count`. |
|
|
342
|
+
| `typechanged` | string | `"T$count"` | Bounded formatter template (4096 characters, 16 nested groups); variables: `$count`. |
|
|
343
|
+
| `staged` | string | `"+$count"` | Bounded formatter template (4096 characters, 16 nested groups); variables: `$count`. |
|
|
344
|
+
| `untracked` | string | `"?$count"` | Bounded formatter template (4096 characters, 16 nested groups); variables: `$count`. |
|
|
345
|
+
| `worktree_added` | string | `"A$count"` | Bounded formatter template (4096 characters, 16 nested groups); variables: `$count`. |
|
|
346
|
+
| `worktree_deleted` | string | `"D$count"` | Bounded formatter template (4096 characters, 16 nested groups); variables: `$count`. |
|
|
347
|
+
| `worktree_modified` | string | `"M$count"` | Bounded formatter template (4096 characters, 16 nested groups); variables: `$count`. |
|
|
348
|
+
| `worktree_typechanged` | string | `"T$count"` | Bounded formatter template (4096 characters, 16 nested groups); variables: `$count`. |
|
|
349
|
+
| `index_added` | string | `"A$count"` | Bounded formatter template (4096 characters, 16 nested groups); variables: `$count`. |
|
|
350
|
+
| `index_deleted` | string | `"D$count"` | Bounded formatter template (4096 characters, 16 nested groups); variables: `$count`. |
|
|
351
|
+
| `index_modified` | string | `"M$count"` | Bounded formatter template (4096 characters, 16 nested groups); variables: `$count`. |
|
|
352
|
+
| `index_typechanged` | string | `"T$count"` | Bounded formatter template (4096 characters, 16 nested groups); variables: `$count`. |
|
|
353
|
+
| `ignore_submodules` | boolean | `false` | Ignore dirty submodule worktrees while retaining changed gitlinks. |
|
|
354
|
+
|
|
355
|
+
### `jj_bookmark`
|
|
356
|
+
|
|
357
|
+
Closest ancestor bookmark in the current Jujutsu repository.
|
|
358
|
+
|
|
359
|
+
- Format variables: `$symbol`, `$bookmark`, `$remote`, `$diverged`, `$overflow_count`.
|
|
360
|
+
- Style variables in `format`: `$style`.
|
|
361
|
+
- Default `format`: `"on [$symbol$bookmark(@$remote)$diverged( \\(+$overflow_count others\\))]($style) "`.
|
|
362
|
+
- Default `symbol`: `" "`.
|
|
363
|
+
- Default `disabled`: `true`.
|
|
364
|
+
|
|
365
|
+
Accepted style fields:
|
|
366
|
+
|
|
367
|
+
| Field | Default |
|
|
368
|
+
| --- | --- |
|
|
369
|
+
| `style` | `"bold purple"` |
|
|
370
|
+
|
|
371
|
+
Additional options:
|
|
372
|
+
|
|
373
|
+
| Option | Type | Default | Constraints and meaning |
|
|
374
|
+
| --- | --- | --- | --- |
|
|
375
|
+
| `truncation_length` | integer | `65535` | Inclusive range 0 through 65535. Controls truncation length; see [module behavior](modules.md) for selection and fallback rules. |
|
|
376
|
+
| `truncation_symbol` | string | `"…"` | Symbol for the truncation state. |
|
|
377
|
+
| `diverged_symbol` | string | `"*"` | Symbol for the diverged state. |
|
|
378
|
+
| `ignore_names` | string array | `[]` | Exact values used by this module's selection policy; see module behavior. |
|
|
379
|
+
| `ignore_remotes` | string array | `[]` | Exact values used by this module's selection policy; see module behavior. |
|
|
380
|
+
|
|
381
|
+
### `jj_change`
|
|
382
|
+
|
|
383
|
+
Current Jujutsu change and commit identity.
|
|
384
|
+
|
|
385
|
+
- Format variables: `$change`, `$commit`, `$change_prefix`, `$change_suffix`, `$change_offset`, `$commit_prefix`, `$commit_suffix`.
|
|
386
|
+
- Style variables in `format`: `$prefix_style`, `$suffix_style`, `$change_offset_style`.
|
|
387
|
+
- Default `format`: `"$change "`.
|
|
388
|
+
- Default `symbol`: `""`.
|
|
389
|
+
- Default `disabled`: `true`.
|
|
390
|
+
|
|
391
|
+
Accepted style fields:
|
|
392
|
+
|
|
393
|
+
| Field | Default |
|
|
394
|
+
| --- | --- |
|
|
395
|
+
| `prefix_style` | `"green bold"` |
|
|
396
|
+
| `suffix_style` | `"dimmed"` |
|
|
397
|
+
| `change_offset_style` | `"bold"` |
|
|
398
|
+
|
|
399
|
+
Additional options:
|
|
400
|
+
|
|
401
|
+
| Option | Type | Default | Constraints and meaning |
|
|
402
|
+
| --- | --- | --- | --- |
|
|
403
|
+
| `change_hash_length` | integer | `7` | Inclusive range 0 through 255. Controls change hash length; see [module behavior](modules.md) for selection and fallback rules. |
|
|
404
|
+
| `commit_hash_length` | integer | `7` | Inclusive range 0 through 255. Controls commit hash length; see [module behavior](modules.md) for selection and fallback rules. |
|
|
405
|
+
|
|
406
|
+
### `jj_metrics`
|
|
407
|
+
|
|
408
|
+
Added and deleted lines in the current Jujutsu change.
|
|
409
|
+
|
|
410
|
+
- Format variables: `$added`, `$deleted`.
|
|
411
|
+
- Style variables in `format`: `$added_style`, `$deleted_style`.
|
|
412
|
+
- Default `format`: `"([+$added]($added_style) )([-$deleted]($deleted_style) )"`.
|
|
413
|
+
- Default `symbol`: `""`.
|
|
414
|
+
- Default `disabled`: `true`.
|
|
415
|
+
|
|
416
|
+
Accepted style fields:
|
|
417
|
+
|
|
418
|
+
| Field | Default |
|
|
419
|
+
| --- | --- |
|
|
420
|
+
| `added_style` | `"bold green"` |
|
|
421
|
+
| `deleted_style` | `"bold red"` |
|
|
422
|
+
|
|
423
|
+
Additional options:
|
|
424
|
+
|
|
425
|
+
| Option | Type | Default | Constraints and meaning |
|
|
426
|
+
| --- | --- | --- | --- |
|
|
427
|
+
| `only_nonzero_diffs` | boolean | `true` | Controls only nonzero diffs; see [module behavior](modules.md) for selection and fallback rules. |
|
|
428
|
+
|
|
429
|
+
### `jj_status`
|
|
430
|
+
|
|
431
|
+
Current Jujutsu change status.
|
|
432
|
+
|
|
433
|
+
- Format variables: `$all`, `$conflicted`, `$description`, `$hidden`, `$immutable`, `$added`, `$copied`, `$deleted`, `$modified`, `$renamed`.
|
|
434
|
+
- Style variables in `format`: `$style`.
|
|
435
|
+
- Default `format`: `"([\\[$all\\]]($style) )"`.
|
|
436
|
+
- Default `symbol`: `""`.
|
|
437
|
+
- Default `disabled`: `true`.
|
|
438
|
+
|
|
439
|
+
Accepted style fields:
|
|
440
|
+
|
|
441
|
+
| Field | Default |
|
|
442
|
+
| --- | --- |
|
|
443
|
+
| `style` | `"bold red"` |
|
|
444
|
+
|
|
445
|
+
Additional options:
|
|
446
|
+
|
|
447
|
+
| Option | Type | Default | Constraints and meaning |
|
|
448
|
+
| --- | --- | --- | --- |
|
|
449
|
+
| `conflicted` | string | `"!"` | Bounded formatter template (4096 characters, 16 nested groups); no content variables. |
|
|
450
|
+
| `description_empty` | string | `"◌"` | Bounded formatter template (4096 characters, 16 nested groups); no content variables. |
|
|
451
|
+
| `description_present` | string | `""` | Bounded formatter template (4096 characters, 16 nested groups); no content variables. |
|
|
452
|
+
| `hidden` | string | `""` | Bounded formatter template (4096 characters, 16 nested groups); no content variables. |
|
|
453
|
+
| `immutable` | string | `"◆"` | Bounded formatter template (4096 characters, 16 nested groups); no content variables. |
|
|
454
|
+
| `added` | string | `"+"` | Bounded formatter template (4096 characters, 16 nested groups); variables: `$count`. |
|
|
455
|
+
| `copied` | string | `"="` | Bounded formatter template (4096 characters, 16 nested groups); variables: `$count`. |
|
|
456
|
+
| `deleted` | string | `"✘"` | Bounded formatter template (4096 characters, 16 nested groups); variables: `$count`. |
|
|
457
|
+
| `modified` | string | `"~"` | Bounded formatter template (4096 characters, 16 nested groups); variables: `$count`. |
|
|
458
|
+
| `renamed` | string | `"»"` | Bounded formatter template (4096 characters, 16 nested groups); variables: `$count`. |
|
|
459
|
+
|
|
295
460
|
### `package`
|
|
296
461
|
|
|
297
462
|
Current workspace package version and manifest source.
|
|
@@ -313,6 +478,7 @@ Additional options:
|
|
|
313
478
|
| Option | Type | Default | Constraints and meaning |
|
|
314
479
|
| --- | --- | --- | --- |
|
|
315
480
|
| `version_format` | string | `"v$raw"` | May be empty. Version template in which `$raw` is replaced with the collected version. |
|
|
481
|
+
| `display_private` | boolean | `true` | Display package.json versions with private=true; false can fall through to the next supported manifest. |
|
|
316
482
|
|
|
317
483
|
### `nodejs`
|
|
318
484
|
|
|
@@ -329,6 +495,7 @@ Accepted style fields:
|
|
|
329
495
|
| Field | Default |
|
|
330
496
|
| --- | --- |
|
|
331
497
|
| `style` | `"bold green"` |
|
|
498
|
+
| `not_capable_style` | `"none"` |
|
|
332
499
|
|
|
333
500
|
Additional options:
|
|
334
501
|
|
|
@@ -363,6 +530,11 @@ Additional options:
|
|
|
363
530
|
| `detect_files` | string array | `[]` | Entries may start with `!`. Direct current-directory file-name detectors; a non-empty array replaces that module's built-in file defaults. |
|
|
364
531
|
| `detect_extensions` | string array | `[]` | Entries may start with `!`. Direct current-directory extension detectors without a leading dot; a non-empty array replaces built-in extension defaults. |
|
|
365
532
|
| `detect_folders` | string array | `[]` | Entries may start with `!`. Direct current-directory folder-name detectors; a non-empty array replaces built-in folder defaults. |
|
|
533
|
+
| `pyenv_version_name` | boolean | `false` | Use the current PYENV_VERSION name instead of the interpreter version when available. |
|
|
534
|
+
| `pyenv_prefix` | string | `"pyenv "` | Text supplied as $pyenv_prefix in pyenv mode. |
|
|
535
|
+
| `python_binary` | command alternatives | `[]` | Scalar command or ordered command/argv alternatives; at most 16 alternatives, 16 arguments each, and 1024 characters per argument, without controls. Empty preserves current interpreter selection. |
|
|
536
|
+
| `detect_env_vars` | string array | `[]` | Presence detectors: positive names are OR conditions and !name vetoes presence, including empty values; an empty list preserves the module's existing detection. |
|
|
537
|
+
| `generic_venv_names` | string array | `[]` | Virtualenv basenames replaced with the parent-directory name. |
|
|
366
538
|
|
|
367
539
|
### `rust`
|
|
368
540
|
|
|
@@ -404,6 +576,7 @@ Accepted style fields:
|
|
|
404
576
|
| Field | Default |
|
|
405
577
|
| --- | --- |
|
|
406
578
|
| `style` | `"bold cyan"` |
|
|
579
|
+
| `not_capable_style` | `"none"` |
|
|
407
580
|
|
|
408
581
|
Additional options:
|
|
409
582
|
|
|
@@ -487,6 +660,8 @@ Additional options:
|
|
|
487
660
|
| `detect_files` | string array | `[]` | Entries may not start with `!`. Direct current-directory file-name detectors; a non-empty array replaces that module's built-in file defaults. |
|
|
488
661
|
| `detect_extensions` | string array | `[]` | Entries may not start with `!`. Direct current-directory extension detectors without a leading dot; a non-empty array replaces built-in extension defaults. |
|
|
489
662
|
| `detect_folders` | string array | `[]` | Entries may not start with `!`. Direct current-directory folder-name detectors; a non-empty array replaces built-in folder defaults. |
|
|
663
|
+
| `healthy_symbol` | string | `"healthy"` | Symbol for the healthy state. |
|
|
664
|
+
| `unhealthy_symbol` | string | `"issues"` | Symbol for the unhealthy state. |
|
|
490
665
|
|
|
491
666
|
### `direnv`
|
|
492
667
|
|
|
@@ -511,6 +686,12 @@ Additional options:
|
|
|
511
686
|
| `detect_files` | string array | `[]` | Entries may not start with `!`. Direct current-directory file-name detectors; a non-empty array replaces that module's built-in file defaults. |
|
|
512
687
|
| `detect_extensions` | string array | `[]` | Entries may not start with `!`. Direct current-directory extension detectors without a leading dot; a non-empty array replaces built-in extension defaults. |
|
|
513
688
|
| `detect_folders` | string array | `[]` | Entries may not start with `!`. Direct current-directory folder-name detectors; a non-empty array replaces built-in folder defaults. |
|
|
689
|
+
| `detect_env_vars` | string array | `[]` | Presence detectors: positive names are OR conditions and !name vetoes presence, including empty values; an empty list preserves the module's existing detection. |
|
|
690
|
+
| `allowed_msg` | string | `"allowed"` | Replacement display text for the allowed state. |
|
|
691
|
+
| `not_allowed_msg` | string | `"not allowed"` | Replacement display text for the not allowed state. |
|
|
692
|
+
| `denied_msg` | string | `"denied"` | Replacement display text for the denied state. |
|
|
693
|
+
| `loaded_msg` | string | `"loaded"` | Replacement display text for the loaded state. |
|
|
694
|
+
| `unloaded_msg` | string | `"not loaded"` | Replacement display text for the unloaded state. |
|
|
514
695
|
|
|
515
696
|
### `conda`
|
|
516
697
|
|
|
@@ -533,7 +714,8 @@ Additional options:
|
|
|
533
714
|
| Option | Type | Default | Constraints and meaning |
|
|
534
715
|
| --- | --- | --- | --- |
|
|
535
716
|
| `ignore_base` | boolean | `true` | Hides the Conda module when `CONDA_DEFAULT_ENV` is exactly `base`. |
|
|
536
|
-
| `
|
|
717
|
+
| `detect_env_vars` | string array | `[]` | Presence detectors: positive names are OR conditions and !name vetoes presence, including empty values; an empty list preserves the module's existing detection. |
|
|
718
|
+
| `truncation_length` | integer | `1` | Inclusive range 0 through 1000000. Inclusive range 0 through 1000000. Number of trailing environment-path components retained; zero keeps the complete value. |
|
|
537
719
|
|
|
538
720
|
### `pixi`
|
|
539
721
|
|
|
@@ -577,6 +759,13 @@ Accepted style fields:
|
|
|
577
759
|
| --- | --- |
|
|
578
760
|
| `style` | `"bold blue"` |
|
|
579
761
|
|
|
762
|
+
Additional options:
|
|
763
|
+
|
|
764
|
+
| Option | Type | Default | Constraints and meaning |
|
|
765
|
+
| --- | --- | --- | --- |
|
|
766
|
+
| `pure_msg` | string | `"pure"` | Replacement display text for the pure state. |
|
|
767
|
+
| `impure_msg` | string | `"impure"` | Replacement display text for the impure state. |
|
|
768
|
+
|
|
580
769
|
### `guix_shell`
|
|
581
770
|
|
|
582
771
|
Current Guix shell state.
|
|
@@ -638,11 +827,16 @@ Additional options:
|
|
|
638
827
|
|
|
639
828
|
| Option | Type | Default | Constraints and meaning |
|
|
640
829
|
| --- | --- | --- | --- |
|
|
830
|
+
| `detect_files` | string array | `[]` | Direct current-directory files detectors; a nonempty array replaces built-in defaults. A leading ! is a rejection rule. |
|
|
831
|
+
| `detect_extensions` | string array | `[]` | Direct current-directory extensions detectors; a nonempty array replaces built-in defaults. A leading ! is a rejection rule. |
|
|
832
|
+
| `detect_folders` | string array | `[]` | Direct current-directory folders detectors; a nonempty array replaces built-in defaults. A leading ! is a rejection rule. |
|
|
833
|
+
| `detect_env_vars` | string array | `[]` | Presence detectors: positive names are OR conditions and !name vetoes presence, including empty values; an empty list preserves the module's existing detection. |
|
|
834
|
+
| `contexts` | context-rule array | `[]` | At most 64 first-match rules with required context_pattern and optional user_pattern, symbol, style, context_alias, and user_alias; patterns use bounded RE2 full matching. |
|
|
641
835
|
| `context_aliases` | string-to-string table | `{}` | Keys and values are strings. Exact Kubernetes context-name to display-label replacements. |
|
|
642
836
|
| `namespace_aliases` | string-to-string table | `{}` | Keys and values are strings. Exact Kubernetes namespace-name to display-label replacements. |
|
|
643
837
|
| `cluster_aliases` | string-to-string table | `{}` | Keys and values are strings. Exact Kubernetes cluster-name to display-label replacements. |
|
|
644
838
|
| `user_aliases` | string-to-string table | `{}` | Keys and values are strings. Exact Kubernetes user-name to display-label replacements. |
|
|
645
|
-
| `max_config_files` | integer | `8` | Inclusive range 1 through 32. Maximum number of `KUBECONFIG` files read from left to right. |
|
|
839
|
+
| `max_config_files` | integer | `8` | Inclusive range 1 through 32. Inclusive range 1 through 32. Maximum number of `KUBECONFIG` files read from left to right. |
|
|
646
840
|
|
|
647
841
|
### `terraform`
|
|
648
842
|
|
|
@@ -714,6 +908,7 @@ Additional options:
|
|
|
714
908
|
| --- | --- | --- | --- |
|
|
715
909
|
| `project_aliases` | string-to-string table | `{}` | Keys and values are strings. Exact project-name to display-label replacements. |
|
|
716
910
|
| `region_aliases` | string-to-string table | `{}` | Keys and values are strings. Exact region-name to display-label replacements. |
|
|
911
|
+
| `detect_env_vars` | string array | `[]` | Presence detectors: positive names are OR conditions and !name vetoes presence, including empty values; an empty list preserves the module's existing detection. |
|
|
717
912
|
|
|
718
913
|
### `azure`
|
|
719
914
|
|
|
@@ -820,6 +1015,8 @@ Additional options:
|
|
|
820
1015
|
| Option | Type | Default | Constraints and meaning |
|
|
821
1016
|
| --- | --- | --- | --- |
|
|
822
1017
|
| `ssh_only` | boolean | `true` | Shows hostname only when `SSH_CONNECTION` or `SSH_TTY` is present. |
|
|
1018
|
+
| `ssh_symbol` | string | `"🌐 "` | Symbol for the ssh state. |
|
|
1019
|
+
| `detect_env_vars` | string array | `[]` | Presence detectors: positive names are OR conditions and !name vetoes presence, including empty values; an empty list preserves the module's existing detection. |
|
|
823
1020
|
| `trim_at` | string | `"."` | May be empty. Removes the first occurrence of this delimiter and everything after it before hostname alias lookup; empty disables trimming. |
|
|
824
1021
|
| `aliases` | string-to-string table | `{}` | Keys and values are strings. Exact collected value to display-label replacements for this module. |
|
|
825
1022
|
|
|
@@ -848,6 +1045,53 @@ Additional options:
|
|
|
848
1045
|
| `aliases` | string-to-string table | `{}` | Keys and values are strings. Exact collected value to display-label replacements for this module. |
|
|
849
1046
|
| `detect_env_vars` | string array | `[]` | Entries may not start with `!`. Environment-variable names whose presence makes username visible; negated names are rejected. |
|
|
850
1047
|
|
|
1048
|
+
### `memory_usage`
|
|
1049
|
+
|
|
1050
|
+
Current system memory and available swap usage.
|
|
1051
|
+
|
|
1052
|
+
- Format variables: `$symbol`, `$ram`, `$ram_pct`, `$swap`, `$swap_pct`.
|
|
1053
|
+
- Style variables in `format`: `$style`.
|
|
1054
|
+
- Default `format`: `"via $symbol[$ram( \| $swap)]($style) "`.
|
|
1055
|
+
- Default `symbol`: `"🐏 "`.
|
|
1056
|
+
- Default `disabled`: `true`.
|
|
1057
|
+
|
|
1058
|
+
Accepted style fields:
|
|
1059
|
+
|
|
1060
|
+
| Field | Default |
|
|
1061
|
+
| --- | --- |
|
|
1062
|
+
| `style` | `"white bold dimmed"` |
|
|
1063
|
+
|
|
1064
|
+
Additional options:
|
|
1065
|
+
|
|
1066
|
+
| Option | Type | Default | Constraints and meaning |
|
|
1067
|
+
| --- | --- | --- | --- |
|
|
1068
|
+
| `threshold` | number | `75` | Inclusive range -100 through 10000. Display threshold applied to the collected percentage; see module behavior. |
|
|
1069
|
+
|
|
1070
|
+
### `battery`
|
|
1071
|
+
|
|
1072
|
+
Local battery charge and charging state on supported platforms.
|
|
1073
|
+
|
|
1074
|
+
- Format variables: `$symbol`, `$percentage`.
|
|
1075
|
+
- Style variables in `format`: `$style`.
|
|
1076
|
+
- Default `format`: `"[$symbol$percentage]($style) "`.
|
|
1077
|
+
- Default `symbol`: `""`.
|
|
1078
|
+
- Default `disabled`: `true`.
|
|
1079
|
+
|
|
1080
|
+
Accepted state-selected style field:
|
|
1081
|
+
|
|
1082
|
+
- `display`: array of tables with finite numeric `threshold`, valid string `style`, and boolean `hidden`.
|
|
1083
|
+
- Default `display`: `[{"threshold":10,"style":"red bold","hidden":false}]`.
|
|
1084
|
+
|
|
1085
|
+
Additional options:
|
|
1086
|
+
|
|
1087
|
+
| Option | Type | Default | Constraints and meaning |
|
|
1088
|
+
| --- | --- | --- | --- |
|
|
1089
|
+
| `full_symbol` | string | `" "` | Symbol for the full state. |
|
|
1090
|
+
| `charging_symbol` | string | `" "` | Symbol for the charging state. |
|
|
1091
|
+
| `discharging_symbol` | string | `" "` | Symbol for the discharging state. |
|
|
1092
|
+
| `unknown_symbol` | string | `" "` | Symbol for the unknown state. |
|
|
1093
|
+
| `empty_symbol` | string | `" "` | Symbol for the empty state. |
|
|
1094
|
+
|
|
851
1095
|
### `activity`
|
|
852
1096
|
|
|
853
1097
|
Current Pi activity, extension UI wait, or most recently completed tool.
|
|
@@ -942,6 +1186,15 @@ Accepted style fields:
|
|
|
942
1186
|
| --- | --- |
|
|
943
1187
|
| `style` | `"bold yellow"` |
|
|
944
1188
|
|
|
1189
|
+
Additional options:
|
|
1190
|
+
|
|
1191
|
+
| Option | Type | Default | Constraints and meaning |
|
|
1192
|
+
| --- | --- | --- | --- |
|
|
1193
|
+
| `use_12hr` | boolean | `false` | Select the 12-hour fallback format when time_format is empty. |
|
|
1194
|
+
| `time_format` | string | `""` | Bounded strftime subset; empty selects the Pi HH:mm default or 12-hour fallback. See module behavior for supported tokens and invalid-value fallback. |
|
|
1195
|
+
| `utc_time_offset` | string | `"local"` | local, a decimal hour offset strictly between -24 and 24, UTC, or a supported IANA zone. Invalid values use local time. |
|
|
1196
|
+
| `time_range` | string | `"-"` | Local-clock visibility interval with strict optional endpoints; '-' leaves the clock unrestricted. See module behavior for midnight and invalid-endpoint rules. |
|
|
1197
|
+
|
|
945
1198
|
### `turn`
|
|
946
1199
|
|
|
947
1200
|
Current user-turn count.
|
|
@@ -995,7 +1248,7 @@ Additional options:
|
|
|
995
1248
|
|
|
996
1249
|
| Option | Type | Default | Constraints and meaning |
|
|
997
1250
|
| --- | --- | --- | --- |
|
|
998
|
-
| `separator` | string | `" • "` |
|
|
999
|
-
| `max_statuses` | integer | `5` | Inclusive range 0 through 100.
|
|
1000
|
-
| `icons` | string-to-string table | `{}` |
|
|
1001
|
-
| `styles` | string-to-style table | `{}` | Valid Starship
|
|
1251
|
+
| `separator` | string | `" • "` | Text inserted between rendered extension statuses. |
|
|
1252
|
+
| `max_statuses` | integer | `5` | Inclusive range 0 through 100. Zero hides all status values. |
|
|
1253
|
+
| `icons` | string-to-string table | `{}` | Exact raw status keys, explicit namespace wildcards, and optional fallback. |
|
|
1254
|
+
| `styles` | string-to-style table | `{}` | Valid Starship styles by exact raw key, namespace wildcard, or fallback. |
|