pi-env-probe

Cross-platform environment diagnostics for Pi — shell, PATH, runtime, encoding, and non-ASCII path risks in compact JSON.

What this is

pi-env-probe collects lightweight environment diagnostics and returns them as compact JSON. Use it from the CLI, as a Pi slash command, or import probe() in your own tooling.

Features

• Detects the current shell (bash, pwsh, cmd, zsh, or null)
• Reports whether common shells are available in PATH
• Returns the platform path separator (; on Windows, : on POSIX)
• Never throws from probe() — subprocess failures degrade to false / null

Install

Install the published npm package with Pi:

pi install npm:pi-env-probe

Install into the current project instead of your user Pi settings:

pi install npm:pi-env-probe -l

Or install from GitHub:

pi install git:github.com/eiei114/pi-env-probe

Try it without permanently installing:

pi -e npm:pi-env-probe

Quick start

Try this package locally:

pi -e .

Then run:

/env-probe

Or use the standalone CLI:

node bin/env-probe.js

Package contents

| Path | Purpose | |---|---| | lib/ | Shared probe logic (probe.ts) | | extensions/ | Pi extension registering /env-probe | | bin/ | Standalone CLI entry point |

Development

npm install
npm run ci

Verification

npm install
npm run typecheck
npm test
node bin/env-probe.js
node bin/env-probe.js | node -e "process.stdin.on('data',d=>{JSON.parse(d);console.log('valid JSON')})"
npm pack --dry-run

Release

This package is set up for npm Trusted Publishing, so no NPM_TOKEN is required.

npm version patch
git push --follow-tags

License

MIT — see LICENSE.