Quick Start

This guide will get you resolving JVM dependencies in under 5 minutes.

Initialize a Project

Create a new antlers.toml configuration file:

antlers init

This creates a minimal configuration with Maven Central:

[project]
name = "my-project"
version = "0.1.0"

[[repositories]]
id = "central"
name = "Maven Central"
url = "https://repo1.maven.org/maven2/"
ecosystem = "maven"

Note: the CLI currently uses antlers.toml for init, add, show, and fmt. Resolution is driven by CLI arguments, not the file (yet).

Resolve a Dependency

Resolve a single artifact and its transitive dependencies:

antlers resolve org.jetbrains.kotlin:kotlin-stdlib:2.0.0

Output:

✓ org.jetbrains.kotlin:kotlin-stdlib:2.0.0 (3 artifacts)
# org.jetbrains.kotlin:kotlin-stdlib:2.0.0
  org.jetbrains.kotlin:kotlin-stdlib:2.0.0 (abc123...)
  org.jetbrains:annotations:13.0 (def456...)
  org.jetbrains.kotlin:kotlin-stdlib-common:2.0.0 (789...)

Add a Repository

Need artifacts from JitPack, Jenkins, or another repository?

# Add a preset repository
antlers add repo jitpack --preset

# Add a custom repository
antlers add repo mycompany https://maven.mycompany.com/releases/

# Add with authentication
antlers add repo github https://maven.pkg.github.com/org/repo --token-env GITHUB_TOKEN

Different Output Formats

# JSON output
antlers resolve com.google.guava:guava:33.0.0-jre --format json

# Dependency tree
antlers resolve com.google.guava:guava:33.0.0-jre --format tree

# Buck2 build file
antlers resolve com.google.guava:guava:33.0.0-jre --format buck

Import Existing Configuration

Already have Maven or Gradle configured? Import your settings:

# Auto-detect and import from all found configs
antlers init --detect

# Import from a specific file
antlers init --from ~/.m2/settings.xml

This imports repositories and credentials from:

  • Maven settings.xml
  • Gradle settings.gradle / settings.gradle.kts
  • Ivy ivysettings.xml
  • npm .npmrc
  • pip pip.conf

Next Steps