Download `merv-client` (Java CLI)

Standalone Java command-line tool for Merv-Local — same commands as npx merv-client for show-report, show-logs, and doctor setup. Requires Java 17+ on your machine.

All downloads

Pick a platform launcher (script only — JAR auto-downloads on first run) or a full package (script + JAR bundled). Every option is listed below.

Platform	File	Description	Size	Download
Windows	`merv-client.bat`	Windows launcher (`.bat`). Saves `merv-client.jar` to `.\lib\` on first run. Run from Command Prompt or PowerShell.	—	Download
macOS / Linux / Unix	`merv-client`	Shell launcher for macOS, Linux, and other Unix systems. Saves `merv-client.jar` to `./lib/` on first run.	—	Download
All platforms	`merv-client-cli.zip`	Full ZIP package (flat layout): `merv-client`, `merv-client.bat`, and `lib/merv-client.jar` at the package root. No network needed on first run.	—	Download
macOS / Linux	`merv-client-cli.tar.gz`	Same contents as the ZIP — preferred when extracting with `tar -xzf` on macOS or Linux.	—	Download
All platforms	`merv-client.jar`	Fat JAR only. Use with a launcher script above, or run directly: `java -jar merv-client.jar show-logs`	—	Download
Metadata	`merv-client.version.json`	Version manifest — URLs, Java minimum, and release date for launchers and CI.	—	Download

Platform launchers (quick start)

Windows — `merv-client.bat`

Download the Windows launcher, place it in your Java project folder, then:

merv-client.bat doctor setup
merv-client.bat show-logs
merv-client.bat doctor set console

Requires Java 17+ on PATH. First run downloads merv-client.jar into lib\.

macOS / Linux / Unix — `merv-client`

Download the shell launcher, make it executable, then:

chmod +x merv-client
./merv-client doctor setup
./merv-client show-logs
./merv-client doctor set console

Requires Java 17+. First run downloads merv-client.jar into ./lib/.

Auto-download (no local JAR)

Place merv-client or merv-client.bat in your project root. On first run, the launcher creates ./lib/ and downloads the JAR there:

project/
  merv-client          # or merv-client.bat on Windows
  lib/
    merv-client.jar    # created automatically on first run

./merv-client show-report
# → downloads https://merv.online/downloads/merv-client.jar
# → saves to ./lib/merv-client.jar

Override the download base URL:

export MERV_CLIENT_DOWNLOAD_URL=https://merv.online/downloads   # macOS / Linux
set MERV_CLIENT_DOWNLOAD_URL=https://merv.online/downloads        # Windows

Install (full package)

ZIP or tar.gz (includes JAR — offline first run)

unzip merv-client-cli.zip
# or: tar -xzf merv-client-cli.tar.gz
cd merv-client-4.0.22
# layout: ./merv-client  ./merv-client.bat  ./lib/merv-client.jar
export PATH="$PWD:$PATH"
merv-client doctor setup
merv-client show-logs

Commands

Command	Description
`merv-client doctor setup`	Create/heal `merv.properties` for Java/Maven
`merv-client doctor setup-log`	Merv-Logs only
`merv-client doctor set console`	`System.out` → `MervSystem`; SLF4J/Log4j → `MervLogger`
`merv-client doctor unset console`	Revert `MervSystem` / `MervLogger` wiring
`merv-client show-report`	Serve local HTML reports (port 6174)
`merv-client show-logs`	Open Merv-Logs directly

Maven library

For tests and reporters, add the library dependency (CLI is optional):

<dependency>
  <groupId>io.github.techelliiptica</groupId>
  <artifactId>merv-client-api</artifactId>
  <version>4.0.22</version>
</dependency>

See Merv-Logs and Merv-Local documentation.

← Back to Merv-Local documentation

Download merv-client (Java CLI)