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 Sat Aug 23 22:28:13 UTC 2025 against commit ad23f13ad23f131bfecd82ea8a12d9b3e92aab5d8398ae9.

Current version is 7.0.2129 (website) which has been verified against tests cases.