getting started

Dwarvish is a (mostly) POSIX compliant shell and tiny functional programming language, written in Rust.

Currently, there are two ways to get dwarvish. First, you may install it through cargo, as it is published on crates.io. Although it will likely work, this is not recommended, as you will be missing some configuration files you’ll probably want. Instead, the recommended way is to build dwarvish yourself from source. To do this, you will need the following three programs on your system: rustc, cargo, and make.

Building dwarvish is simple:

git clone git://git.dwarvish.org/dwarvish.git
cd dwarvish
make

This installs dwarvish’s binary, dwvsh, alongside some run command (or rc) files for configuration.

We hope to package dwarvish soon for your favorite distro and/or operating system. If you are interested in staying apprised of our developments, consider subscribing to the anno@ mailing list.