nushell/docs/commands/which.md

which

Finds a program file.

Usage:

which {flags}

Parameters

• application: the name of the command to find the path to

Flags

• --all: list all executables

Examples

which finds the location of an executable:

> which python
─────────┬─────────────────
 arg     │ python
 path    │ /usr/bin/python
 builtin │ false
─────────┴─────────────────

> which cargo
─────────┬────────────────────────────
 arg     │ cargo
 path    │ /home/bob/.cargo/bin/cargo
 builtin │ false
─────────┴────────────────────────────

which will identify nushell commands:

> which ls
─────────┬──────────────────────────
 arg     │ ls
 path    │ nushell built-in command
 builtin │ true
─────────┴──────────────────────────

> which which
─────────┬──────────────────────────
 arg     │ which
 path    │ nushell built-in command
 builtin │ true
─────────┴──────────────────────────

Passing the all flag identifies all instances of a command or binary

> which ls --all
───┬─────┬──────────────────────────┬─────────
 # │ arg │ path                     │ builtin
───┼─────┼──────────────────────────┼─────────
 0 │ ls  │ nushell built-in command │ true
 1 │ ls  │ /bin/ls                  │ false
───┴─────┴──────────────────────────┴─────────

which will also identify local binaries

> touch foo
> chmod +x foo
> which ./foo
─────────┬────────────────────────────────
 arg     │ ./foo
 path    │ /Users/josephlyons/Desktop/foo
 builtin │ false
─────────┴────────────────────────────────

which also identifies aliases

> alias e = echo
> which e
───┬─────┬───────────────┬─────────
 # │ arg │     path      │ builtin
───┼─────┼───────────────┼─────────
 0 │ e   │ Nushell alias │ false
───┴─────┴───────────────┴─────────

and custom commands

> def my_cool_echo [arg] { echo $arg }
> which my_cool_echo
───┬──────────────┬────────────────────────┬─────────
 # │     arg      │          path          │ builtin
───┼──────────────┼────────────────────────┼─────────
 0 │ my_cool_echo │ Nushell custom command │ false
───┴──────────────┴────────────────────────┴─────────