nushell-mcp

name	nushell-mcp
description	Use when running workspace-oriented Nushell commands through the Nushell MCP tools in Codex.

Nushell MCP Tool

Use nu_run for call-scoped Nushell execution against the active Codex workspace.

Pass caller data through args; inside the script, read it from $args. Keep paths, regexes, snippets, and other non-trivial values in args so the Nushell source remains focused on command structure.

Prefer Nushell structured commands and pipelines over text-only adapters. Use records, lists, tables, where, select, get, first, last, sort-by, and to json-compatible values when shaping results.

When nu_run returns next_page, call nu_page with the provided arguments to continue reading the result. Treat result_id as an opaque handle scoped to the stored result.

Use nu_scope to inspect Nushell command metadata, and use nu_version when the available Nu executable or platform details matter.