Install Mergeway CLI

Use one of the installation paths below depending on whether you need the CLI only or both the CLI and the language server.

Option 1: Download a Release Archive

GitHub releases publish platform assets for:

• Linux, macOS, and Windows
• amd64 and arm64
• both mergeway-cli and mergeway-lsp

Download the asset or assets for your platform from the latest release page, then install the extracted binaries you need:

install -m 0755 mergeway-cli /usr/local/bin/mergeway-cli
install -m 0755 mergeway-lsp /usr/local/bin/mergeway-lsp

Put mergeway-cli on PATH for terminal use and mergeway-lsp on PATH for editor integration.

Option 2: Docker

The published container image is useful for CLI-only workflows:

docker run --rm ghcr.io/mergewayhq/mergeway-cli version

To run against the workspace in your current directory:

docker run --rm \
  -v "$PWD:/work" \
  ghcr.io/mergewayhq/mergeway-cli validate

The container image does not include mergeway-lsp.

Option 3: Go Install

go install github.com/mergewayhq/mergeway-cli@latest

This installs mergeway-cli. If you also need mergeway-lsp, use a release archive or build from source.

Option 4: Nix

Install the CLI with Nix:

nix profile install github:mergewayhq/mergeway-cli

Or run it directly:

nix run github:mergewayhq/mergeway-cli -- help

The flake path is currently oriented around the CLI. Use a release archive or a local source build if you also need mergeway-lsp.

Option 5: Build from Source

git clone https://github.com/mergewayhq/mergeway-cli.git
cd mergeway-cli
make build
./bin/mergeway-cli version
./bin/mergeway-lsp --log-stderr --log-level=debug

make build produces both binaries under bin/.

Supported Platforms

• Release archives support Linux, macOS, and Windows.
• Each release includes amd64 and arm64 builds.
• The container image is Linux-only and CLI-only.

Verify the Installation

mergeway-cli version
mergeway-lsp --log-stderr --log-level=debug

If the language server starts successfully, it waits for LSP input on stdin. Stop it with Ctrl+C.

For manual startup and editor wiring, continue with Run mergeway-lsp manually.