Change Directory: cd

Change (working) directory

Description

Changes current working directory.

Usage

cd [path]

Examples

Home directory

» cd ~

Running cd without a parameter will also change to the current user’s home directory:

» cd

Previous directory

» cd -

Absolute path

» cd /etc/

Relative path

» cd Documents
» cd ./Documents

Detail

$PWDHIST

cd updates an environmental variable, $PWDHIST with an array of paths. You can then use that to change to a previous directory.

View the working directory history

» $PWDHIST

Change to a previous directory

» cd $PWDHIST[-1]

cd - is syntactic sugar for $PWDHIST[-1]

auto-cd

Some people prefer to omit cd and just write the path, with their shell automatically changing to that directory if the “command” is just a directory. In Murex you can enable this behaviour by turning on “auto-cd”:

config set shell auto-cd true

See Also

This document was generated from builtins/core/management/functions_doc.yaml.

This site's content is rebuilt automatically from murex's source code after each merge to the master branch. Downloadable murex binaries are also built with the website.

Last built on Sun Jan 11 23:29:10 UTC 2026 against commit c710027c71002785e97a5d5fafbc0316e62c78a04812403.

Current version is 7.1.4143 (unknown) which has been verified against tests cases.