pi-nushell

A Pi extension that adds a Nushell command-execution tool.

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.1.1
Published
Sep 9, 2026
Downloads
309/mo · 309/wk
Author
grfwings
License
Unlicense
Types
extension
Size
8.8 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 that adds a nu tool for executing nushell commands.

The tool follows 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.

Requirements

  • nushell

Install

pi install npm:pi-nushell

For development, load the extension directly:

pi -e ./index.ts

Tool input

{
  "command": "open package.json | get scripts",
  "timeout": 30
}
  • command is required and must use nushell syntax.
  • timeout is optional and is measured in seconds. There is no default timeout.

This extension uses nushell's command-string mode, meaning it does not load configuration files like config.nu.