W3cubDocs

/Nushell

rm for filesystem

Remove files and directories.

Signature

> rm {flags} (filename) ...rest

Flags

  • --trash, -t: move to the platform's trash instead of permanently deleting. not used on android and ios
  • --permanent, -p: delete permanently, ignoring the 'always_trash' config option. always enabled on android and ios
  • --recursive, -r: delete subdirectories recursively
  • --force, -f: suppress error when no file
  • --verbose, -v: print names of deleted files
  • --interactive, -i: ask user to confirm action
  • --interactive-once, -I: ask user to confirm action only once

Parameters

  • filename: the path of the file you want to remove
  • ...rest: additional file path(s) to remove

Input/output types:

input output
nothing nothing

Examples

Delete, or move a file to the trash (based on the 'always_trash' config option)

>rmfile.txt

Move a file to the trash

>rm--trashfile.txt

Delete a file permanently, even if the 'always_trash' config option is true

>rm--permanentfile.txt

Delete a file, ignoring 'file not found' errors

>rm--forcefile.txt

Delete all 0KB files in the current directory

>ls|wheresize==0KBandtype==file|each { rm$in.name } |null

Copyright © 2019–2023 The Nushell Project DevelopersLicensed under the MIT License.
https://www.nushell.sh/commands/docs/rm.html