pi-pwsh-native 0.1.1 → 0.1.2

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/CHANGELOG.md CHANGED
@@ -2,6 +2,13 @@
2
2
 
3
3
  All notable changes to this project will be documented here.
4
4
 
5
+ ## 0.1.2 — 2026-07-30
6
+
7
+ ### Added
8
+
9
+ - `pi` npm keyword for broader package-gallery discoverability.
10
+ - README comparison with the audited `@4fu/pi-pwsh@0.6.2` baseline.
11
+
5
12
  ## 0.1.1 — 2026-07-30
6
13
 
7
14
  ### Added
package/README.md CHANGED
@@ -7,6 +7,29 @@ Native PowerShell 7 tooling for the [Pi coding agent](https://pi.dev/) on Window
7
7
 
8
8
  `pi-pwsh-native` replaces Pi's model-callable `bash` tool with a tool named `pwsh` and routes interactive `!`/`!!` commands through the same verified PowerShell executable. It does not translate Bash syntax and does not silently fall back to another shell.
9
9
 
10
+ ![PowerShell 7 preview](https://raw.githubusercontent.com/takomine/pi-pwsh-native/main/public/img.png)
11
+
12
+ ## How this differs from `@4fu/pi-pwsh`
13
+
14
+ This package derives from [`@4fu/pi-pwsh`](https://github.com/4fuu/pi-pwsh), but it is a deliberately leaner shell replacement rather than a drop-in feature superset. The comparison below is against the audited upstream baseline, `@4fu/pi-pwsh@0.6.2`.
15
+
16
+ | Area | `pi-pwsh-native` | `@4fu/pi-pwsh@0.6.2` |
17
+ |---|---|---|
18
+ | Primary focus | Predictable, dependency-free foreground PowerShell execution | Feature-rich PowerShell execution with persistent jobs and interactive sessions |
19
+ | Model shell tool | Replaces `bash` with `pwsh` | Replaces `bash` with `pwsh` |
20
+ | Pi discovery tools | Preserves `ls`, `find`, and `grep` by default | Disables `ls`, `find`, and `grep` in favor of PowerShell |
21
+ | Interactive `!` / `!!` | Routes both through the verified PowerShell runtime | Does not replace Pi's `user_bash` handling |
22
+ | PowerShell executable | Resolves, verifies, and retains an absolute PowerShell 7 path | Probes PowerShell 7, while foreground execution invokes `pwsh` by name |
23
+ | Execution policy | No override by default; `Bypass` must be explicitly configured | Passes `-ExecutionPolicy Bypass` |
24
+ | Command transport | UTF-8 base64 source over stdin, avoiding Windows command-line limits | Injected source passed through `-Command` |
25
+ | `.cmd` fallback | No retry through `cmd.exe` | Can retry failed direct command-shim execution through `cmd /c` |
26
+ | Background jobs and PTYs | Intentionally omitted from the lean core | Includes detached jobs, ConPTY sessions, and user-request helpers |
27
+ | Runtime dependencies | None | Uses `node-pty` and `@xterm/headless` |
28
+ | Configuration | Strict JSON configuration plus environment overrides | Primarily opinionated built-in behavior |
29
+ | Missing/invalid PowerShell | Fails visibly without silently restoring Bash | Leaves the built-in Bash tool active when PowerShell is unavailable |
30
+
31
+ Choose `pi-pwsh-native` when you want a small, auditable PowerShell 7 replacement with dedicated Pi file/search tools left intact. Choose `@4fu/pi-pwsh` when persistent background jobs, PTYs, and its interactive helper layer are more important. Do not enable competing shell-adapter extensions simultaneously.
32
+
10
33
  ## Design
11
34
 
12
35
  - Registers a real `pwsh` tool so models are prompted to write PowerShell, not POSIX shell syntax.
@@ -36,7 +59,7 @@ The initial implementation is developed and tested against:
36
59
  Install the pinned npm release:
37
60
 
38
61
  ```powershell
39
- pi install npm:pi-pwsh-native@0.1.1
62
+ pi install npm:pi-pwsh-native@0.1.2
40
63
  ```
41
64
 
42
65
  Alternatively, install the public GitHub package directly:
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "pi-pwsh-native",
3
- "version": "0.1.1",
3
+ "version": "0.1.2",
4
4
  "description": "Native PowerShell 7 tooling for the Pi coding agent on Windows",
5
5
  "license": "MIT",
6
6
  "author": "Tako (https://github.com/takomine)",
@@ -24,6 +24,7 @@
24
24
  },
25
25
  "keywords": [
26
26
  "pi-package",
27
+ "pi",
27
28
  "pi-extension",
28
29
  "powershell",
29
30
  "pwsh",