From 6baf1bfe82fca8852c9abb0158c6f11357e1a14f Mon Sep 17 00:00:00 2001
From: claude <claude@anthropic.com>
Date: Wed, 31 Dec 2025 00:07:01 -0300
Subject: [PATCH 1/5] docs: document missing commands in README
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Add documentation for 4 public commands that were exported in mod.nu
but missing from README:
- generate-numd
- extract-command-code
- list-exported-commands
- module-commands-code-to-record

Also add help block for set-x showing --regex and --quiet flags.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 README.md | 145 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 145 insertions(+)

diff --git a/README.md b/README.md
index eb26822..c6960ae 100644
--- a/README.md
+++ b/README.md
@@ -253,6 +253,32 @@ dotnu filter-commands-with-no-tests --help
 
 ### dotnu set-x
 
+```nushell
+dotnu set-x --help
+# => Open a regular .nu script. Divide it into blocks by "\n\n". Generate a new script
+# => that will print the code of each block before executing it, and print the timings of each block's execution.
+# =>
+# => Usage:
+# =>   > set-x {flags} <file>
+# =>
+# => Flags:
+# =>   -h, --help: Display the help message for this command
+# =>   --regex <string>: regex to use to split .nu on blocks (default: '\n+\n')
+# =>   --echo: output script to terminal
+# =>   --quiet: don't print any messages
+# =>
+# => Parameters:
+# =>   file <path>: path to `.nu` file
+# =>
+# => Input/output types:
+# =>   ╭───┬───────┬────────╮
+# =>   │ # │ input │ output │
+# =>   ├───┼───────┼────────┤
+# =>   │ 0 │ any   │ any    │
+# =>   ╰───┴───────┴────────╯
+# =>
+```
+
 `dotnu set-x` opens a regular .nu script. It divides it into blocks using the specified regex (by default, it is "\n\n") and generates a new script that will print the code of each block before executing it, along with the timings of each block's execution.
 
 Let's check the code of the simple `set-x-demo.nu` script
@@ -292,3 +318,122 @@ dotnu set-x $filename --echo | lines | table -i false
 # => │                                                                                 │
 # => ╰─────────────────────────────────────────────────────────────────────────────────╯
 ```
+
+### dotnu generate-numd
+
+```nushell
+dotnu generate-numd --help
+# => Generate `.numd` from `.nu` divided on blocks by "\n\n"
+# =>
+# => Usage:
+# =>   > generate-numd
+# =>
+# => Flags:
+# =>   -h, --help: Display the help message for this command
+# =>
+# => Input/output types:
+# =>   ╭───┬───────┬────────╮
+# =>   │ # │ input │ output │
+# =>   ├───┼───────┼────────┤
+# =>   │ 0 │ any   │ any    │
+# =>   ╰───┴───────┴────────╯
+# =>
+```
+
+Pipe a `.nu` script into this command to convert it into `.numd` format (markdown with code blocks).
+
+```nushell
+"sleep 0.5sec\n\nsleep 0.7sec" | dotnu generate-numd
+# => ```nu
+# => sleep 0.5sec
+# => ```
+# =>
+# => ```nu
+# => sleep 0.7sec
+# => ```
+# =>
+```
+
+### dotnu extract-command-code
+
+```nushell
+dotnu extract-command-code --help
+# => Extract a command code from a module and save it as a `.nu` file that can be sourced.
+# => By executing this `.nu` file, you'll have all the variables in your environment for debugging or development.
+# =>
+# => Usage:
+# =>   > extract-command-code {flags} <$module_path> <$command>
+# =>
+# => Flags:
+# =>   -h, --help: Display the help message for this command
+# =>   --output <path>: a file path to save the extracted command script
+# =>   --clear-vars: clear variables previously set in the extracted .nu file
+# =>   --echo: output the command to the terminal
+# =>   --set-vars <record>: set variables for a command (default: {})
+# =>   --code-editor <string>: code is my editor of choice to open the result file (default: 'code')
+# =>
+# => Parameters:
+# =>   $module_path <path>: path to a Nushell module file
+# =>   $command <string>: the name of the command to extract
+# =>
+# => Input/output types:
+# =>   ╭───┬───────┬────────╮
+# =>   │ # │ input │ output │
+# =>   ├───┼───────┼────────┤
+# =>   │ 0 │ any   │ any    │
+# =>   ╰───┴───────┴────────╯
+# =>
+```
+
+This command is useful for debugging. It extracts a command from a module, resolves its parameter defaults, and creates a standalone script you can source to get all variables in scope.
+
+### dotnu list-exported-commands
+
+```nushell
+dotnu list-exported-commands --help
+# => Usage:
+# =>   > list-exported-commands {flags} <$path>
+# =>
+# => Flags:
+# =>   -h, --help: Display the help message for this command
+# =>   --export: use only commands that are exported
+# =>
+# => Parameters:
+# =>   $path <path>
+# =>
+# => Input/output types:
+# =>   ╭───┬───────┬────────╮
+# =>   │ # │ input │ output │
+# =>   ├───┼───────┼────────┤
+# =>   │ 0 │ any   │ any    │
+# =>   ╰───┴───────┴────────╯
+# =>
+```
+
+List commands defined in a module file. Use `--export` to show only exported commands.
+
+### dotnu module-commands-code-to-record
+
+```nushell
+dotnu module-commands-code-to-record --help
+# => Extract the specified command and all its dependencies, outputting them to stdout
+# =>
+# => Usage:
+# =>   > module-commands-code-to-record <module_path>
+# =>
+# => Flags:
+# =>   -h, --help: Display the help message for this command
+# =>
+# => Parameters:
+# =>   module_path <path>: path to a Nushell module file
+# =>
+# => Input/output types:
+# =>   ╭───┬───────┬────────╮
+# =>   │ # │ input │ output │
+# =>   ├───┼───────┼────────┤
+# =>   │ 0 │ any   │ any    │
+# =>   ╰───┴───────┴────────╯
+# =>
+```
+
+Extracts all commands from a module file and returns them as a record where keys are command names and values are their source code.

From 3e48e4b16aabb4c40f26c52e17d251ba14cb876f Mon Sep 17 00:00:00 2001
From: claude <claude@anthropic.com>
Date: Wed, 31 Dec 2025 00:08:53 -0300
Subject: [PATCH 2/5] docs: fix grammar and phrasing in commands.nu
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- "divided on blocks" → "divided into blocks"
- "a command code" → "command code"
- "nushell cli" → "Nushell CLI"
- Add missing space after # in todo comment
- "separately here" → "separate"
- "make a record" → "Make a record" (sentence case)
- Fix module-commands-code-to-record docstring to match actual behavior
- "result" → "results" (plural)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 dotnu/commands.nu | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/dotnu/commands.nu b/dotnu/commands.nu
index e712631..078f4a9 100644
--- a/dotnu/commands.nu
+++ b/dotnu/commands.nu
@@ -91,14 +91,14 @@ export def 'set-x' [
     }
 }
 
-# Generate `.numd` from `.nu` divided on blocks by "\n\n"
+# Generate `.numd` from `.nu` divided into blocks by "\n\n"
 export def 'generate-numd' [] {
     split row -r "\n+\n"
     | each { $"```nu\n($in)\n```\n" }
     | to text
 }
 
-# Extract a command code from a module and save it as a `.nu` file that can be sourced.
+# Extract command code from a module and save it as a `.nu` file that can be sourced.
 # By executing this `.nu` file, you'll have all the variables in your environment for debugging or development.
 export def 'extract-command-code' [
     $module_path: path # path to a Nushell module file
@@ -155,7 +155,7 @@ export def 'extract-command-code' [
     }
 }
 
-# todo: `list-exported-commands` should be a completion for nushell cli
+# todo: `list-exported-commands` should be a completion for Nushell CLI
 
 export def 'list-exported-commands' [
     $path: path
@@ -179,7 +179,7 @@ export def 'list-exported-commands' [
     } else { }
 }
 
-#todo: make configuration like --autocommit in file itself
+# todo: make configuration like --autocommit in file itself
 
 # Inserts captured output back into the script at capture points
 export def 'embeds-update' [
@@ -337,7 +337,7 @@ export def --env 'embeds-capture-stop' []: nothing -> nothing {
 }
 
 #### helpers
-# they used to be separately here from the main code, but I want to experiment with structure
+# they used to be separate from the main code, but I want to experiment with structure
 # so all the commands are in one file now, and all are exported, to be available in my scripts
 # that can use this file commands with 'use ..', though main commands are exported in mod.nu
 
@@ -386,7 +386,7 @@ export def check-clean-working-tree [
     }
 }
 
-# make a record from code with variable definitions
+# Make a record from code with variable definitions
 @example '' {
     "let $quiet = false; let no_timestamp = false" | variable-definitions-to-record
 } --result {quiet: false no_timestamp: false}
@@ -561,7 +561,7 @@ export def list-module-commands [
     $calls | append $defs_without_calls
 }
 
-# Extract the specified command and all its dependencies, outputting them to stdout
+# Extract all commands from a module as a record of {command_name: source_code}
 export def 'module-commands-code-to-record' [
     module_path: path # path to a Nushell module file
 ] {
@@ -709,7 +709,7 @@ export def 'comment-hash-colon' [
     }
 }
 
-# Extracts captured output from a script file execution result
+# Extract captured output from a script file execution results
 export def execute-and-parse-results [
     script: string
     --script_path: path

From c68c60220490573c3972f440fb8ac0d2d8a65f13 Mon Sep 17 00:00:00 2001
From: Maxim Uvarov <maxim-uvarov@users.noreply.github.com>
Date: Wed, 31 Dec 2025 00:09:44 -0300
Subject: [PATCH 3/5] docs: update numd blocks

---
 README.md | 17 +++++++++++++----
 1 file changed, 13 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index c6960ae..7d28f8d 100644
--- a/README.md
+++ b/README.md
@@ -263,7 +263,9 @@ dotnu set-x --help
 # =>
 # => Flags:
 # =>   -h, --help: Display the help message for this command
-# =>   --regex <string>: regex to use to split .nu on blocks (default: '\n+\n')
+# =>   --regex <string>: regex to use to split .nu on blocks (default: '
+# => +
+# => ')
 # =>   --echo: output script to terminal
 # =>   --quiet: don't print any messages
 # =>
@@ -277,6 +279,13 @@ dotnu set-x --help
 # =>   │ 0 │ any   │ any    │
 # =>   ╰───┴───────┴────────╯
 # =>
+# => Examples:
+# =>
+# =>   > set-x tests/assets/set-x-demo.nu --echo | lines | first 3 | to text
+# =>   mut $prev_ts = ( date now )
+# =>   print ("> sleep 0.5sec" | nu-highlight)
+# =>   sleep 0.5sec
+# =>
 ```
 
 `dotnu set-x` opens a regular .nu script. It divides it into blocks using the specified regex (by default, it is "\n\n") and generates a new script that will print the code of each block before executing it, along with the timings of each block's execution.
@@ -323,7 +332,7 @@ dotnu set-x $filename --echo | lines | table -i false
 
 ```nushell
 dotnu generate-numd --help
-# => Generate `.numd` from `.nu` divided on blocks by "\n\n"
+# => Generate `.numd` from `.nu` divided into blocks by "\n\n"
 # =>
 # => Usage:
 # =>   > generate-numd
@@ -358,7 +367,7 @@ Pipe a `.nu` script into this command to convert it into `.numd` format (markdow
 
 ```nushell
 dotnu extract-command-code --help
-# => Extract a command code from a module and save it as a `.nu` file that can be sourced.
+# => Extract command code from a module and save it as a `.nu` file that can be sourced.
 # => By executing this `.nu` file, you'll have all the variables in your environment for debugging or development.
 # =>
 # => Usage:
@@ -416,7 +425,7 @@ List commands defined in a module file. Use `--export` to show only exported com
 
 ```nushell
 dotnu module-commands-code-to-record --help
-# => Extract the specified command and all its dependencies, outputting them to stdout
+# => Extract all commands from a module as a record of {command_name: source_code}
 # =>
 # => Usage:
 # =>   > module-commands-code-to-record <module_path>

From 4dde1c6fc736ff138847f25bfe342536a6983035 Mon Sep 17 00:00:00 2001
From: claude <claude@anthropic.com>
Date: Wed, 31 Dec 2025 00:13:43 -0300
Subject: [PATCH 4/5] docs: restructure README for logical organization
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Reorganize into logical sections: Embeds, Dependency Analysis,
  Script Profiling, Utilities
- Fix heading hierarchy: helper commands now use H4 under H3 parent
- Standardize all code fences to `nushell`
- Remove redundant set-x prose (help block already explains it)
- Remove emoji from title for cleaner look
- Improve descriptions to be before help blocks
- Capitalize section descriptions consistently

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 README.md | 90 ++++++++++++++++++++++++++-----------------------------
 1 file changed, 42 insertions(+), 48 deletions(-)

diff --git a/README.md b/README.md
index 7d28f8d..bc89589 100644
--- a/README.md
+++ b/README.md
@@ -1,12 +1,12 @@
 ![dotnu](https://github.com/user-attachments/assets/4fb74e46-f75b-4155-8e61-8ff75db66117)
 
-<h1 align="center"><strong>dotnu - tools for Nushell module developers 🛠️</strong></h1>
+<h1 align="center"><strong>dotnu - tools for Nushell module developers</strong></h1>
 
 <p align="center"><em>(A good companion for <a href="https://github.com/nushell-prophet/numd">numd</a>)</em></p>
 
 <p align="center">dotnu augments Nushell with helpers for literate programming, dependency analysis, and script profiling.</p>
 
-## dotnu video demo
+## Video demo
 
 <a href="https://youtu.be/-C7_dfLXXrE">
   <img src="https://github.com/user-attachments/assets/fdd07bfc-7d77-4dca-8a1c-3e27ac3063f9" alt="dotnu demo" width="100"/>
@@ -22,6 +22,7 @@ use dotnu
 ```
 
 ### [`nupm`](https://github.com/nushell/nupm)
+
 ```nushell no-run
 nupm install https://github.com/nushell-prophet/dotnu --git
 # if nupm modules are not in  `NU_LIB_DIRS`:
@@ -30,15 +31,15 @@ $env.NU_LIB_DIRS ++= [ ($env.NUPM_HOME | path join "modules") ]
 use dotnu
 ```
 
-## Embeds — keeping examples in sync
+## Embeds — Literate Programming
 
 `dotnu` lets you write **literate Nushell**: ordinary Nushell scripts that include the real command output right after each pipeline ending in `| print $in`. See the [capture example](/dotnu-capture.nu) to grasp the idea quickly.
 
 The `| print $in` suffix acts as a simple `print` in native Nushell and as a capture marker for dotnu, so scripts remain valid and functional even when run without loading the `dotnu` module.
 
-The main command is `dotnu embeds-update`.
+### `dotnu embeds-update`
 
-`dotnu embeds-update` takes a script, rewrites every `print $in` line so its output is easy to parse, runs the modified script, captures what each marked line prints, and then replaces the old `# =>` blocks in the original file with the fresh output.
+The main command. It takes a script, rewrites every `print $in` line so its output is easy to parse, runs the modified script, captures what each marked line prints, and then replaces the old `# =>` blocks in the original file with the fresh output.
 
 You can run it on a file path (e.g., `dotnu embeds-update dotnu-capture.nu`) or pipe a script into it (e.g., `"ls | print $in" | dotnu embeds-update`).
 
@@ -69,15 +70,15 @@ dotnu embeds-update --help
 # =>
 ```
 
-### Embeds helper commands
+### Helper commands
 
-While it is easy to write scripts in editor, there are several convenience helper commands that facilitate populating script files from terminal.
+While it is easy to write scripts in an editor, there are several convenience helper commands that facilitate populating script files from the terminal.
 
-### `dotnu embeds-setup`
+#### `dotnu embeds-setup`
 
-define or change the capture file (add `--auto-commit` to auto‑commit snapshots).
+Define or change the capture file (add `--auto-commit` to auto-commit snapshots).
 
-```nu
+```nushell
 dotnu embeds-setup --help
 # => Set environment variables to operate with embeds
 # =>
@@ -100,11 +101,11 @@ dotnu embeds-setup --help
 # =>
 ```
 
-### `dotnu embeds-capture-start` and `dotnu embeds-capture-stop`
+#### `dotnu embeds-capture-start` and `dotnu embeds-capture-stop`
 
-record every result printed in the interactive session.
+Record every result printed in the interactive session.
 
-```nu
+```nushell
 dotnu embeds-capture-start --help
 # => start capturing commands and their outputs into a file
 # =>
@@ -126,11 +127,11 @@ dotnu embeds-capture-start --help
 # =>
 ```
 
-### `dotnu embed-add`
+#### `dotnu embed-add`
 
-capture only the pipeline you run it on; useful for fine‑grained examples.
+Capture only the pipeline you run it on; useful for fine-grained examples.
 
-```nu
+```nushell
 dotnu embed-add --help
 # => Embed stdin together with its command into the file
 # =>
@@ -152,11 +153,11 @@ dotnu embed-add --help
 # =>
 ```
 
-### `dotnu embeds-remove`
+#### `dotnu embeds-remove`
 
-strip all captured output, leaving clean code.
+Strip all captured output, leaving clean code.
 
-```nu
+```nushell
 dotnu embeds-remove --help
 # => Removes annotation lines starting with "# => " from the script
 # =>
@@ -175,9 +176,9 @@ dotnu embeds-remove --help
 # =>
 ```
 
-## Commands
+## Dependency Analysis
 
-### dotnu dependencies
+### `dotnu dependencies`
 
 ```nushell
 dotnu dependencies --help
@@ -218,7 +219,7 @@ dotnu dependencies --help
 # =>
 ```
 
-### dotnu filter-commands-with-no-tests
+### `dotnu filter-commands-with-no-tests`
 
 ```nushell
 dotnu filter-commands-with-no-tests --help
@@ -251,7 +252,11 @@ dotnu filter-commands-with-no-tests --help
 # =>
 ```
 
-### dotnu set-x
+## Script Profiling
+
+### `dotnu set-x`
+
+Divide a script into blocks and generate a new script that prints each block before executing it, along with timing information.
 
 ```nushell
 dotnu set-x --help
@@ -263,9 +268,7 @@ dotnu set-x --help
 # =>
 # => Flags:
 # =>   -h, --help: Display the help message for this command
-# =>   --regex <string>: regex to use to split .nu on blocks (default: '
-# => +
-# => ')
+# =>   --regex <string>: regex to use to split .nu on blocks (default: '\n+\n')
 # =>   --echo: output script to terminal
 # =>   --quiet: don't print any messages
 # =>
@@ -279,18 +282,9 @@ dotnu set-x --help
 # =>   │ 0 │ any   │ any    │
 # =>   ╰───┴───────┴────────╯
 # =>
-# => Examples:
-# =>
-# =>   > set-x tests/assets/set-x-demo.nu --echo | lines | first 3 | to text
-# =>   mut $prev_ts = ( date now )
-# =>   print ("> sleep 0.5sec" | nu-highlight)
-# =>   sleep 0.5sec
-# =>
 ```
 
-`dotnu set-x` opens a regular .nu script. It divides it into blocks using the specified regex (by default, it is "\n\n") and generates a new script that will print the code of each block before executing it, along with the timings of each block's execution.
-
-Let's check the code of the simple `set-x-demo.nu` script
+Example with a simple script:
 
 ```nushell
 let $filename = [tests assets set-x-demo.nu] | path join
@@ -304,8 +298,6 @@ open $filename | lines | table -i false
 # => ╰──────────────╯
 ```
 
-Let's see how `dotnu set-x` will modify this script
-
 ```nushell
 dotnu set-x $filename --echo | lines | table -i false
 # => ╭─────────────────────────────────────────────────────────────────────────────────╮
@@ -328,7 +320,11 @@ dotnu set-x $filename --echo | lines | table -i false
 # => ╰─────────────────────────────────────────────────────────────────────────────────╯
 ```
 
-### dotnu generate-numd
+## Utilities
+
+### `dotnu generate-numd`
+
+Pipe a `.nu` script into this command to convert it into `.numd` format (markdown with code blocks).
 
 ```nushell
 dotnu generate-numd --help
@@ -349,8 +345,6 @@ dotnu generate-numd --help
 # =>
 ```
 
-Pipe a `.nu` script into this command to convert it into `.numd` format (markdown with code blocks).
-
 ```nushell
 "sleep 0.5sec\n\nsleep 0.7sec" | dotnu generate-numd
 # => ```nu
@@ -363,7 +357,9 @@ Pipe a `.nu` script into this command to convert it into `.numd` format (markdow
 # =>
 ```
 
-### dotnu extract-command-code
+### `dotnu extract-command-code`
+
+Extract a command from a module, resolve its parameter defaults, and create a standalone script you can source to get all variables in scope. Useful for debugging.
 
 ```nushell
 dotnu extract-command-code --help
@@ -394,9 +390,9 @@ dotnu extract-command-code --help
 # =>
 ```
 
-This command is useful for debugging. It extracts a command from a module, resolves its parameter defaults, and creates a standalone script you can source to get all variables in scope.
+### `dotnu list-exported-commands`
 
-### dotnu list-exported-commands
+List commands defined in a module file. Use `--export` to show only exported commands.
 
 ```nushell
 dotnu list-exported-commands --help
@@ -419,9 +415,9 @@ dotnu list-exported-commands --help
 # =>
 ```
 
-List commands defined in a module file. Use `--export` to show only exported commands.
+### `dotnu module-commands-code-to-record`
 
-### dotnu module-commands-code-to-record
+Extract all commands from a module file and return them as a record where keys are command names and values are their source code.
 
 ```nushell
 dotnu module-commands-code-to-record --help
@@ -444,5 +440,3 @@ dotnu module-commands-code-to-record --help
 # =>   ╰───┴───────┴────────╯
 # =>
 ```
-
-Extracts all commands from a module file and returns them as a record where keys are command names and values are their source code.

From 200d9e4fefaf091bc586dcc138e9dfc509e6d1ff Mon Sep 17 00:00:00 2001
From: claude <claude@anthropic.com>
Date: Wed, 31 Dec 2025 00:17:44 -0300
Subject: [PATCH 5/5] fix: move regex default to description to avoid multiline
 help output
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The default value "\n+\n" contains actual newlines which caused
awkward multi-line display in --help output. Now uses optional
parameter with default applied in function body, and documents
the default in the description.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 README.md                             | 9 ++++++++-
 dotnu/commands.nu                     | 3 ++-
 tests/assets/dotnu-capture-updated.nu | 2 +-
 3 files changed, 11 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index bc89589..40e98c5 100644
--- a/README.md
+++ b/README.md
@@ -268,7 +268,7 @@ dotnu set-x --help
 # =>
 # => Flags:
 # =>   -h, --help: Display the help message for this command
-# =>   --regex <string>: regex to use to split .nu on blocks (default: '\n+\n')
+# =>   --regex <string>: regex to split on blocks (default: '\n+\n' - blank lines)
 # =>   --echo: output script to terminal
 # =>   --quiet: don't print any messages
 # =>
@@ -282,6 +282,13 @@ dotnu set-x --help
 # =>   │ 0 │ any   │ any    │
 # =>   ╰───┴───────┴────────╯
 # =>
+# => Examples:
+# =>
+# =>   > set-x tests/assets/set-x-demo.nu --echo | lines | first 3 | to text
+# =>   mut $prev_ts = ( date now )
+# =>   print ("> sleep 0.5sec" | nu-highlight)
+# =>   sleep 0.5sec
+# =>
 ```
 
 Example with a simple script:
diff --git a/dotnu/commands.nu b/dotnu/commands.nu
index 078f4a9..cea43b9 100644
--- a/dotnu/commands.nu
+++ b/dotnu/commands.nu
@@ -60,10 +60,11 @@ sleep 0.5sec
 '
 export def 'set-x' [
     file: path # path to `.nu` file
-    --regex: string = "\n+\n" # regex to use to split .nu on blocks
+    --regex: string # regex to split on blocks (default: '\n+\n' - blank lines)
     --echo # output script to terminal
     --quiet # don't print any messages
 ] {
+    let regex = $regex | default "\n+\n"
     let out_file = $file | str replace -r '(\.nu)?$' '_setx.nu'
 
     open $file
diff --git a/tests/assets/dotnu-capture-updated.nu b/tests/assets/dotnu-capture-updated.nu
index 2f4ee77..ba29e9e 100644
--- a/tests/assets/dotnu-capture-updated.nu
+++ b/tests/assets/dotnu-capture-updated.nu
@@ -15,7 +15,7 @@ ls | sort-by modified -r | last 2 | print $in
 # => ╰───┴──────────────────────────────┴──────┴───────┴────────────╯
 
 random int | print $in
-# => 4577019228065240114
+# => 315585275042786947
 
 'Say hello to the core team of the Nushell'
 | str replace 'Nushell' 'Best shell'