nushell / nushell/nushell

Commands called `update` Show Incorrect Documentation

Open
#18,236 4 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

status:needs-triage
Dominant language
Rust
Stars
40.5k
Forks
2.3k
Avg merge
1d 14h
Merged PRs (30d)
79

Description

Bug report form
  • I have done a basic search of the issue tracker to find any existing issues that are similar.
  • I have checked that my version is at least the latest stable release available via my installation method.
Describe the bug

When creating any command or subcommand named update, it will incorrectly show that it provides an update cells subcommand.

How to reproduce
  1. Create a module providing a update command
    lol.nu:
    export def update [] {}
    
    export module test {
        export def update [] {}
    }
    
  2. Notice how each command suggests the existence of a update cells command:
    use lol.nu
    lol update --help
    lol test update --help
    
Expected behavior

Only subcommands actually defined should appear.

Configuration
key value
version 0.112.3
major 0
minor 112
patch 3
branch main
commit_hash cef0dc4b7a1c6faccf0c39eaf389ec1835a76d97
build_os linux-x86_64
build_target x86_64-unknown-linux-gnu
rust_version rustc 1.93.1 (01f6ddf75 2026-02-11)
rust_channel 1.93.1-x86_64-unknown-linux-gnu
cargo_version cargo 1.93.1 (083ac5135 2025-12-15)
build_time 2026-05-18 18:32:49 +02:00
build_rust_channel debug
allocator standard
features default, mcp, network, plugin, rustls-tls, sqlite, trash-support
installed_plugins
experimental_options example=false, reorder-cell-paths=true, pipefail=true, enforce-runtime-annotations=false, native-clip=false, cell-path-types=false

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Reproduce the issue using the lol.nu module and the --help entry points shown in the report. Trace how help output derives subcommands for commands named update; done means only explicitly defined subcommands appear for both lol update --help and lol test update --help.

Written by the indexing model from the issue text.

Assessment

Tech stack
rust, shell
Domain
cli
Issue type
Bug
Difficulty
3/5
Estimated time
1-2 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
55/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.