$ cat ~/map/pi-nushell.md

pi-nushell

Nushell tool extension for pi: shell commands with streamed output, cancellation, and timeouts.

extensions✓ Sep 10

pi install npm:pi-nushell

## TL;DR

A pi extension that adds a nu tool for executing nushell commands, mirroring the built-in bash tool: session working directory, streamed combined output, cancellation, optional timeouts, and nonzero exits reported as tool errors.

## Key points

• $Runs nushell's command-string mode from the current session working directory — configuration files like config.nu are never loaded.
• $Streams combined stdout and stderr, and supports cancellation plus optional per-call timeouts measured in seconds (no default timeout).
• $Reports nonzero exit codes as tool errors; output is capped at the last 2,000 lines or 50 KB, with the complete output saved to a temporary file when truncation happens.
• $Exposes PI_SESSION_ID, PI_SESSION_FILE, PI_PROVIDER, PI_MODEL, and PI_REASONING_LEVEL to the command, matching the built-in bash tool's conventions.
• $Tool input takes a required nushell-syntax command plus an optional timeout in seconds; for development, load the extension directly with pi -e ./index.ts.

## FAQ

## References

• README ↗

Last updated: Sep 10, 2026