Installation

hypha is a single cabal package producing two executables: hypha (the CLI) and hypha-mcp (the MCP stdio shim).

From source (requires GHC ≥ 9.6; tested on 9.6.7, 9.10.3 and 9.12.4)

git clone https://github.com/well-typed/hypha.git
cd hypha
cabal build all
cabal install exe:hypha
cabal install exe:hypha-mcp

Nix (flakes)

The flake provides a development shell with GHC and cabal ready to go:

nix develop github:well-typed/hypha
cabal build all

There is no packaged hypha derivation yet, so nix run has nothing to run — build it from the shell above.

Claude Code plugin

If you drive Claude Code, install the bundled plugin so Claude prefers hypha over WebFetch and ad-hoc grep of ~/.cabal/store. It ships the skill, slash commands, and an auto-registered hypha-mcp MCP server — see Claude Code Plugin.

The plugin does not vendor the binaries. Install hypha and hypha-mcp per From source (or Nix) first, and make sure both are on your $PATH.