@narumitw/pi-starship 0.59.0 → 0.59.1
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 +14 -13
- package/package.json +5 -5
- package/skills/{configuring-pi-starship → configure-pi-starship}/SKILL.md +2 -2
- package/skills/{configuring-pi-starship → configure-pi-starship}/references/configuration.md +1 -1
- /package/skills/{configuring-pi-starship → configure-pi-starship}/references/module-catalog.md +0 -0
- /package/skills/{configuring-pi-starship → configure-pi-starship}/references/modules.md +0 -0
- /package/skills/{configuring-pi-starship → configure-pi-starship}/references/runtime-and-security.md +0 -0
- /package/skills/{configuring-pi-starship → configure-pi-starship}/scripts/apply.mjs +0 -0
- /package/skills/{configuring-pi-starship → configure-pi-starship}/scripts/backup.mjs +0 -0
- /package/skills/{configuring-pi-starship → configure-pi-starship}/scripts/config-path.mjs +0 -0
- /package/skills/{configuring-pi-starship → configure-pi-starship}/scripts/script-support.mjs +0 -0
- /package/skills/{configuring-pi-starship → configure-pi-starship}/scripts/validate.mjs +0 -0
package/README.md
CHANGED
|
@@ -50,13 +50,14 @@ Start Pi with the extension to use the built-in footer without creating a settin
|
|
|
50
50
|
Run `/starship` to inspect the footer, choose a preset, or customize the configuration.
|
|
51
51
|
|
|
52
52
|
The bundled configuration skill is manual-only and is not available for automatic model invocation.
|
|
53
|
-
Run `/skill:
|
|
53
|
+
Run `/skill:configure-pi-starship` before asking Pi to explain or edit `pi-starship.toml`:
|
|
54
54
|
|
|
55
55
|
```text
|
|
56
|
-
/skill:
|
|
57
|
-
/skill:
|
|
56
|
+
/skill:configure-pi-starship explain the aws module
|
|
57
|
+
/skill:configure-pi-starship enable the directory and git_branch modules
|
|
58
58
|
```
|
|
59
59
|
|
|
60
|
+
The skill was renamed from `configuring-pi-starship`; use `/skill:configure-pi-starship` instead of the old invocation.
|
|
60
61
|
The skill loads the relevant reference and validates file edits.
|
|
61
62
|
It does not cover general TOML, shell Starship configuration, extension source development, or unrelated footer work.
|
|
62
63
|
|
|
@@ -76,16 +77,16 @@ Restoring built-in configuration requires an existing settings document to repla
|
|
|
76
77
|
|
|
77
78
|
## ⚙️ Settings
|
|
78
79
|
|
|
79
|
-
The package bundles the `
|
|
80
|
-
Invoke `/skill:
|
|
80
|
+
The package bundles the `configure-pi-starship` skill as the authoritative configuration guide for users and agents.
|
|
81
|
+
Invoke `/skill:configure-pi-starship` before asking Pi how to configure the footer or edit `pi-starship.toml`.
|
|
81
82
|
The skill answers from its references and consults the bundled source only when the public documentation does not cover a question.
|
|
82
83
|
|
|
83
84
|
Read the references directly when preferred:
|
|
84
85
|
|
|
85
|
-
- [Configuration and format](./skills/
|
|
86
|
-
- [Complete module catalog](./skills/
|
|
87
|
-
- [Module behavior](./skills/
|
|
88
|
-
- [Runtime and security](./skills/
|
|
86
|
+
- [Configuration and format](./skills/configure-pi-starship/references/configuration.md) — settings schema, validation and fallback behavior, presets, examples, format grammar, styles, palettes, and display thresholds.
|
|
87
|
+
- [Complete module catalog](./skills/configure-pi-starship/references/module-catalog.md) — exact variables, default formats, symbols, enabled state, style fields, display defaults, option types, ranges, and enum values.
|
|
88
|
+
- [Module behavior](./skills/configure-pi-starship/references/modules.md) — reachability, exact detection defaults, command gates, output semantics, aliases, truncation, and module-specific behavior.
|
|
89
|
+
- [Runtime and security](./skills/configure-pi-starship/references/runtime-and-security.md) — network and command execution, local metadata, cloud and deployment context, fill layout, refresh behavior, and limitations.
|
|
89
90
|
|
|
90
91
|
The only configuration source remains `<getAgentDir()>/pi-starship.toml`.
|
|
91
92
|
A minimal custom document can select and style only the modules it needs:
|
|
@@ -99,7 +100,7 @@ style = "bold blue"
|
|
|
99
100
|
|
|
100
101
|
Provider, model, and thinking modules also accept ordered exact-match `style_rules`.
|
|
101
102
|
For per-extension status colors, add `[extension_status.styles]` entries using raw Pi status keys (or `namespace:*`); unmatched statuses keep the module style.
|
|
102
|
-
See [Configuration and format](./skills/
|
|
103
|
+
See [Configuration and format](./skills/configure-pi-starship/references/configuration.md) for examples and matching rules.
|
|
103
104
|
Use `/starship` for interactive configuration, preview, diagnostics, presets, and recovery.
|
|
104
105
|
Manual file edits load at the next `session_start`, including `/reload`.
|
|
105
106
|
|
|
@@ -127,12 +128,12 @@ Cancelling or losing an upload response cannot undo a Gist already created on Gi
|
|
|
127
128
|
## 🔒 Security and privacy
|
|
128
129
|
|
|
129
130
|
Some opt-in modules read local development, deployment, cloud, host, or user metadata, run bounded local commands, or query GitHub through `gh`.
|
|
130
|
-
Review [Runtime and security](./skills/
|
|
131
|
+
Review [Runtime and security](./skills/configure-pi-starship/references/runtime-and-security.md) before enabling them.
|
|
131
132
|
|
|
132
133
|
## 🚧 Limitations
|
|
133
134
|
|
|
134
135
|
pi-starship is Starship-inspired rather than fully compatible with shell Starship.
|
|
135
|
-
The complete supported and intentionally omitted behavior is documented in [Runtime and security](./skills/
|
|
136
|
+
The complete supported and intentionally omitted behavior is documented in [Runtime and security](./skills/configure-pi-starship/references/runtime-and-security.md).
|
|
136
137
|
|
|
137
138
|
## ➕ Adding a module
|
|
138
139
|
|
|
@@ -150,7 +151,7 @@ packages/pi-starship/
|
|
|
150
151
|
│ └── pi-starship.ts # Footer lifecycle and cached refresh
|
|
151
152
|
├── dist/ # Generated Jiti runtime
|
|
152
153
|
├── scripts/build-runtime.mjs # Runtime builder
|
|
153
|
-
├── skills/
|
|
154
|
+
├── skills/configure-pi-starship/ # Authoritative configuration skill and references
|
|
154
155
|
└── test/ # Behavior and lifecycle coverage
|
|
155
156
|
```
|
|
156
157
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@narumitw/pi-starship",
|
|
3
|
-
"version": "0.59.
|
|
3
|
+
"version": "0.59.1",
|
|
4
4
|
"description": "Native Starship-style TOML statusline and configuration skill for Pi.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"license": "MIT",
|
|
@@ -40,7 +40,7 @@
|
|
|
40
40
|
},
|
|
41
41
|
"dependencies": {
|
|
42
42
|
"@narumitw/pi-tui-kit": "^0.59.0",
|
|
43
|
-
"smol-toml": "^1.9.
|
|
43
|
+
"smol-toml": "^1.9.1",
|
|
44
44
|
"yaml": "^2.9.1"
|
|
45
45
|
},
|
|
46
46
|
"peerDependencies": {
|
|
@@ -48,9 +48,9 @@
|
|
|
48
48
|
"@earendil-works/pi-tui": "*"
|
|
49
49
|
},
|
|
50
50
|
"devDependencies": {
|
|
51
|
-
"@earendil-works/pi-coding-agent": "1.
|
|
52
|
-
"@earendil-works/pi-tui": "1.
|
|
53
|
-
"@types/node": "26.6.
|
|
51
|
+
"@earendil-works/pi-coding-agent": "1.2.0",
|
|
52
|
+
"@earendil-works/pi-tui": "1.2.0",
|
|
53
|
+
"@types/node": "26.6.5",
|
|
54
54
|
"esbuild": "0.28.2",
|
|
55
55
|
"typescript": "7.0.2"
|
|
56
56
|
},
|
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
---
|
|
2
|
-
name:
|
|
2
|
+
name: configure-pi-starship
|
|
3
3
|
description: Configure @narumitw/pi-starship and answer questions about its pi-starship.toml settings. Use when the user asks to create, edit, repair, migrate, or understand pi-starship.toml, or asks which pi-starship module, variable, option, style, palette, preset, or runtime behavior to use. Do not use for generic TOML, shell Starship configuration, pi-starship source-code development, or unrelated footer work.
|
|
4
4
|
license: MIT
|
|
5
5
|
disable-model-invocation: true
|
|
6
6
|
---
|
|
7
7
|
|
|
8
|
-
#
|
|
8
|
+
# Configure pi-starship
|
|
9
9
|
|
|
10
10
|
Answer pi-starship configuration questions or make the requested `pi-starship.toml` change.
|
|
11
11
|
|
package/skills/{configuring-pi-starship → configure-pi-starship}/references/configuration.md
RENAMED
|
@@ -29,7 +29,7 @@ Saving requires separate confirmation, then atomically updates the file and acti
|
|
|
29
29
|
Manual TOML edits load at the next `session_start`, including `/reload` and session replacement.
|
|
30
30
|
Cancellation, disposal, invalid drafts, write failures, and runtime application failures preserve the previous file and footer.
|
|
31
31
|
|
|
32
|
-
The bundled `
|
|
32
|
+
The bundled `configure-pi-starship` skill uses a separate external-edit workflow.
|
|
33
33
|
Before its apply script replaces an existing document, it preserves the inspected document under `<getAgentDir()>/pi-starship/pi-starship-YYYYMMDDHHmm.toml`; these backups use local time and remain after a successful apply.
|
|
34
34
|
Backups are written and flushed under a private temporary name, atomically renamed to their final private file, and followed by flushes of the backup directory and its parent directory before publication continues; a recoverable failure removes the owned temporary file and preserves the active document.
|
|
35
35
|
If configuration publication fails after that backup is durable, the failure reports its retained path; cleanup failures report both their operation and cause without hiding the primary failure.
|
/package/skills/{configuring-pi-starship → configure-pi-starship}/references/module-catalog.md
RENAMED
|
File without changes
|
|
File without changes
|
/package/skills/{configuring-pi-starship → configure-pi-starship}/references/runtime-and-security.md
RENAMED
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
/package/skills/{configuring-pi-starship → configure-pi-starship}/scripts/script-support.mjs
RENAMED
|
File without changes
|
|
File without changes
|