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 Fri Oct 24 08:59:31 UTC 2025 against commit e59ab49e59ab49e1628d8546d2ad8ce5eb1150445f6a940.

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