Skip to content
ekmettPublic

Repository files navigation

hide — Haskell IDE

build coverage code coverage docs build issues commits

Zig: 0.16.0 Haskell GHC: 9.6+

OS: Linux · macOS · Windows

license: BSD-2-Clause OR Apache-2.0 Contributor Covenant: 2.0

docs: read

hide is a Haskell IDE written in Haskell. Edit source, inspect types and diagnostics, build and debug programs, and work with agents. It runs in a terminal, a native Metal/Vulkan window, or a browser, locally or over SSH.

It is also the Turbo Haskell editor, but does not require Turbo Haskell. Use GHC and Haskell Language Server for ordinary Haskell projects, or THC for projects running on Turbo Haskell.

Source editing, compiler output and an agent conversation in hide.

Documentation · Installation

Open a project

hide .
hide Main.hs Other.hs

Open a directory to browse its files and Cabal package, or name the files you want to edit. The default display is a terminal. Use --window for a native window or --web for a browser.

make install installs hide, the short command th, and a thc-edit launcher beside it. With THC installed, thc edit . opens the same editor.

Editing

Browse files and Cabal targets in the sidebar. Tile, cascade or split windows; split views share a buffer and its undo history. Markdown files can be shown as source or rendered text. PNG images open in an image window; other binary files open in the hex editor.

Review edits as an inline or side-by-side diff, or show just the changed regions. Unsaved files show line counts for additions and deletions. Saving checks for changes on disk and offers a comparison when both versions have changed. The Git view covers staged, unstaged and untracked files, with commit, fetch, pull and merge commands.

Menus and the clickable status bar show the available actions and their keys. The editing guide covers controls and default shortcuts; configuration covers rebinding them. See also hex editing and Git.

Haskell

Haskell Language Server supplies types, definitions, completion, renaming and diagnostics, including for unsaved code. Put an HLS compatible with the project's GHC on PATH; hide starts it in the project.

Choose a toolchain and target to build or run. Interactive programs use an embedded terminal. Launch a debugger or attach to a DAP server, set breakpoints, step through code, and inspect the stack and variables.

The Haskell guide covers language tools; running and debugging covers toolchains, terminals and debugger setup.

Agents

Configure an ACP provider in Options > Agents, then open Tools > Conversation. Choose the model and effort in the conversation title. Ask about code, queue another query or steer a running reply. ACP and Copilot can also provide inline completion suggestions.

Agents can read unsaved buffers, use HLS, run builds and tests, operate terminals and debuggers, and make undoable edits through the editor's MCP tools. Configure which operations are allowed, denied or require approval. Review proposed work before allowing it, and expand tool calls to see their details.

See conversations for setup and use, session tools for permissions, and agent skills for workflows.

Sessions and remote projects

Detach and return with hide --resume, or use hide --web --resume to continue in a browser. File > Exit finishes the session.

With hide installed on both machines, open a remote project over SSH:

hide --window buildbox:projects/example
hide --web buildbox:projects/example

Files and tools stay on the remote machine. The display and clipboard stay local. A dropped connection leaves the session running for you to reconnect. See sessions and remote editing.

Build and run

The default build includes native windows, the browser and embedded terminals, along with terminal display and SSH sessions. You need GHC 9.6 or newer, Cabal, pkg-config, utf8proc 2.10+, SDL3 3.4+ and libghostty-vt. Installation covers these dependencies and the Linux font stack.

cabal run hide -- --window .
cabal run hide -- --web .
cabal install exe:hide --installdir="$HOME/.local/bin"

--window selects Metal on macOS and Vulkan elsewhere. Build flags are opt-out: -f-window, -f-web and -f-terminal omit individual components. A minimal terminal-display or remote-server build is:

cabal install exe:hide -f-window -f-web -f-terminal

It needs utf8proc but neither SDL nor Ghostty. Sessions and SSH editing remain available in every build.

Development

Contributing covers builds, checks and source layout. Architecture describes buffers and rendering; design documents record work in progress.

THC is the separate compiler and runtime.

Contact Information

Contributions and bug reports are welcome. Please contact me through GitHub.

-Edward Kmett

Releases

Packages

Contributors

Languages