git clone 'git://github.com/haskell/haskell-mode.git'

Haskell Mode Logo

Haskell Mode for Emacs

This is an Emacs mode for editing, debugging and developing Haskell programs.

Build Status Melpa Status Melpa Stable Status


haskell-mode is best installed as a package.

To install haskell-mode you need to add a package archive repository that distributes haskell-mode. Execute

M-x customize-option RET package-archives

and add

Archive name: melpa-stable
URL or directory name: http://stable.melpa.org/packages/

Fetch list of packages with

M-x package-refresh-contents

and then follow by

M-x package-install RET haskell-mode

Voila! haskell-mode is installed! You should be able to edit Haskell source code in color now.

You need to enable indentation as this does not happen automatically currently. Add this line to your ~/.emacs file:

(add-hook 'haskell-mode-hook 'haskell-indentation-mode)

Haskell-mode has much much much more to offer but the above should get you going!

Advanced configuration

For setup instructions, please consult the integrated haskell-mode Info manual which can be accessed after installation via M-x info-display-manual [RET] haskell-mode. Alternatively, you can also direct your browser to the the online haskell-mode manual for setup and user guide.

Installation - more information

haskell-mode supports GNU Emacs versions 23, 24 and upcoming 25 (snapshot).

haskell-mode is available from melpa-stable (releases) and melpa (git snapshots).

Other means of obtaining haskell-mode include el-get, Emacs Prelude and Debian package.

Emacs23 requires an the use of “cl-lib”. cl-lib.el can be found in the tests/compat directory. Copy cl-lib.el to your emacs directory, e.g. ~/.emacs.d directory and put

(add-to-list 'load-path "~/.emacs.d/")
(require 'cl-lib)

in your .emacs file.

Installation from git repository

Running haskell-mode directly from sources is easy but requires a little preparation:

make EMACS=/path/to/your/emacs

and then adding the following command to your .emacs:

(add-to-list 'load-path "~/lib/emacs/haskell-mode/")
(require 'haskell-mode-autoloads)
(add-to-list 'Info-default-directory-list "~/lib/emacs/haskell-mode/")


If you followed the above you are just a couple of steps away from contributing to haskell-mode.

haskell-mode is activelly seeking contributions from users of haskell-mode. For more information have a look at the wiki page on contributing.

Getting in contact

Have fun!