pi-nushell

A Pi extension to replace Bash with nushell.

Packages

Package details

extension

Install pi-nushell from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:pi-nushell
Package
pi-nushell
Version
0.2.0
Published
Oct 4, 2026
Downloads
306/mo · 23/wk
Author
grfwings
License
Unlicense
Types
extension
Size
8.9 KB
Dependencies
0 dependencies · 3 peers
Pi manifest JSON
{
  "extensions": [
    "./index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-nushell

A pi extension for nushell users.

Pi-nushell does two things:

  • adds a nu tool for executing nushell commands, and disables the bash tool.
  • replaces the !command interpreter with nushell.

The nu tool matches pi's built-in bash tool behavior:

  • runs in the current session working directory.
  • streams combined standard output and standard error.
  • supports cancellation and optional timeouts.
  • reports nonzero exit codes as tool errors.
  • limits output to the last 2,000 lines or 50 KB.
  • saves complete output to a temporary file when truncation occurs.
  • exposes PI_SESSION_ID, PI_SESSION_FILE, PI_PROVIDER, PI_MODEL, and PI_REASONING_LEVEL to the command.
  • uses command-string mode, meaning it does not load configuration files like config.nu.

Pi prepends shellCommandPrefix to user commands before execution, so any configured prefix must use Nushell syntax (or be unset).

Requirements

  • nushell

Install

pi install npm:pi-nushell

For development, load the extension directly:

pi -e ./index.ts