Run Java/Maven builds, tests, apps, Docker services, coverage, and E2E workflows with one CLI.

makevn detects the repository's Java, Maven, Docker, Karate, and coverage setup so developers and AI agents can run the right workflow from the terminal.

See it in action

Developer

makevn doctor
makevn test --name UserRepositoryTest
makevn verify

Live telemetry

makevn clean compile package

Tail logs

makevn compile --tail

Docker verification

makevn docker-up docker-ps-required verify

Codex agent

codex exec --model gpt-5.4 'clean compile and package the project'

OpenCode agent

opencode run -m openai/gpt-5.4 'clean compile and package the project'

Installation

Homebrew

brew install antonillos/tap/makevn

asdf

asdf plugin add makevn https://github.com/antonillos/asdf-makevn.git
MAKEVN_VERSION="$(asdf latest makevn | sed -n '$p')"
asdf install makevn "${MAKEVN_VERSION}"
asdf set -u makevn "${MAKEVN_VERSION}"
asdf reshim makevn "${MAKEVN_VERSION}"

Both channels install the makevn CLI and the makevn-mcp server. See installation options for the release installer and source development instructions.

Quick start

Run this from the root of a Java/Maven repository:

makevn doctor
makevn init       # only when doctor reports missing or stale makevn state
makevn test
makevn verify

Run against another repository:

makevn --repo "/path/to/java-repo" doctor
makevn --repo "/path/to/java-repo" verify-changes-preview
makevn --repo "/path/to/java-repo" verify-changes

Commands

Goal	Command
Inspect repository context	makevn doctor
Initialize local makevn state	makevn init
Run one or more tests	makevn test --name UserRepositoryTest
Build and verify	makevn package, makevn verify
Preview and verify changed modules or tests	makevn verify-changes-preview, makevn verify-changes
Check aggregate or changed-code coverage	makevn coverage, makevn coverage-changes
Start and inspect Docker services	makevn docker-up, makevn docker-ps-required
Run Karate E2E flows	makevn karate-test, makevn karate-all
Run the application	makevn run-app, makevn run-app-bg

Commands can be chained:

makevn clean verify-it

AI agents and MCP

Agents use the same makevn commands as developers. The included MCP server also exposes typed tools such as doctor, clean, compile, package, verify_changes_preview, and verify_changes, so clients can call them directly when they support MCP.

{
  "mcpServers": {
    "makevn": {
      "command": "makevn-mcp"
    }
  }
}

See AI agent use and the MCP guide for the full agent workflow and client configuration.

Optional Make integration

makevn init does not touch root makefiles. Install namespaced vn-* targets only when you want them:

makevn make install
make -f .makevn/makevn.mk vn-doctor

Documentation

• Install
• Agent install
• AI agents
• CLI contract
• Backend contract
• Integration
• Distribution

License

MIT. See LICENSE.