jbx toolbox logojbx

install

Install the current project into a Maven repository layout, usually ~/.m2/repository.

When to use it

  • Make a local artifact available to another script via //DEPS.
  • Test generated POM metadata before publish.
  • Install a snapshot into an isolated local repository for CI.

Common workflows

jbx install --file jbx.json
jbx install --file jbx.json --destination build/local-m2
jbx install src/main/java/com/acme/Tool.java

Real-life examples

Install a local artifact into an isolated Maven repo

jbx install --file jbx.json --destination build/local-m2
jbx resolve --repo local=build/local-m2 com.acme:tool:1.0.0

Use install to test Maven metadata and local consumption before publishing or wiring another script to the artifact. The descriptor fields are documented in the jbx.json reference.

Agent loop

  1. Build or check the project first.
  2. Install into an explicit temporary destination for CI/review loops.
  3. Resolve the installed coordinate from that destination.
  4. Inspect generated POM and metadata when publish behavior is involved.

Agent notes

Defaulting to ~/.m2/repository is convenient for humans but noisy for agents. Prefer --destination build/local-m2 in reproducible workflows.

Verification checklist

  • Jar, sources/javadocs where applicable, POM, and metadata are present under Maven layout.
  • A follow-up jbx resolve --repo local=<dest> <gav> succeeds.
  • No real Maven Central publishing occurs from an install flow.

Arguments and flags

This section is copied from the CLI help for this release so the page explains the actual accepted arguments.

jbx install

Install the current project into a Maven repository layout

Usage: jbx install [OPTIONS] [SCRIPT]

Arguments:
  [SCRIPT]  Java source file to install. Defaults to jbx.json main when --file is used

Options:
      --file <FILE>                jbx descriptor file. Defaults to ./jbx.json when present
      --version <VERSION>          Override version from jbx.json or //GAV
      --destination <DESTINATION>  Destination Maven repository root. Defaults to ~/.m2/repository
      --target-dir <TARGET_DIR>    Working directory for staged install artifacts
      --package <PACKAGE_NAME>     Override package used when staging default-package sources
      --cache-dir <CACHE_DIR>      Override cache directory
  -h, --help                       Print help

Skill

Agents can fetch the matching versioned skill with:

jbx skill get jbx-install