A Terminal User Interface for the Glasgow Haskell Compiler Interactive Mode
Go to file
2024-01-15 02:12:47 -08:00
.github/workflows Add basic github haskell CI 2023-10-15 01:21:43 -07:00
app Clean up Daemon start up and messaging 2024-01-15 02:12:47 -08:00
assets Some more early development 2023-06-06 22:19:12 -07:00
lib/Ghcitui Clean up Daemon start up and messaging 2024-01-15 02:12:47 -08:00
test Add submodule Ghcitui for all library components 2024-01-15 02:12:47 -08:00
.gitignore Add .gitignore 2023-06-03 19:36:39 -07:00
cabal.project Add cabal.project 2023-10-14 21:32:14 -07:00
CHANGELOG.md Some more early development 2023-06-06 22:19:12 -07:00
CONTRIBUTING.md Add section on profiling in CONTRIBUTING.md 2024-01-15 02:12:47 -08:00
fourmolu.yaml Add fourmolu.yaml 2023-06-03 19:36:09 -07:00
fswatch_build.sh Run tests with the fswatch_build.sh 2024-01-15 02:12:47 -08:00
ghcitui.cabal Clean up Daemon start up and messaging 2024-01-15 02:12:47 -08:00
INSTALL.rst Update docs substantially 2024-01-15 02:12:47 -08:00
LICENSE Newline at the end of the LICENSE 2023-10-08 00:38:41 -07:00
MANUAL.rst Add more detail about navigation in the MANUAL.rst 2024-01-15 02:12:47 -08:00
README.md Update docs substantially 2024-01-15 02:12:47 -08:00

GHCiTUI: Interactive terminal interface for the Glasgow Haskell Compiler

          /       ______    __  __    ______    __
        //       /\  ___\  /\ \_\ \  /\  ___\  /\_\
       //     ___\ \ \__ \_\ \  __ \_\ \ \_____\ \ \___
' , _ //      \   \ \_____\ \ \_\ \_\ \ \_____\ \ \_\  \
 / \ // 7      \   \/_____/  \/_/\/_/  \/_____/  \/_/   \
    "   \       \           ______   __  __    __        \
    a   a        \         /\__  _\ /\ \/\ \  /\ \        \
 |_      \        \________\/_/\ \/_\ \ \_\ \_\ \ \________\
   '._    '                   \ \_\  \ \_____\ \ \_\
     (' _ '                    \/_/   \/_____/  \/_/

This is an experimental front-end terminal interface for ghci. It provides a source viewer, keybindings, an interactive interpreter, and a local context viewer.

Installation

As this project is experimental, currently installing from source is the only option.

See INSTALLATION.rst for details.

Basic Usage

For detailed usage, please see the manual.

Starting the TUI

GHCiTUI runs a repl in the current directory by default.

$ cd your/cabal/project/root/directory
$ ghcitui

You can specify another directory with the -C <DIR> flag.

$ ghcitui -C some/other/directory

Quitting the TUI

Press <ESC> or q while in the code viewport panel to quit. While not in the code viewport panel, you may press <ESC> to get to the viewport panel.

Contributing

Contributors are welcome! Please see CONTRIBUTING.md to see how.