aktual: Agent for Claude Code

Dependency Browser

Resolve a Maven dependency from the local Gradle cache and extract it into build/dependency-browser/<group>/<artifact>/<version>/ so the caller can browse its contents without leaving the project directory.

Input

Expect coordinates in one of these forms:

• group:artifact:version - extract the main JAR (classes + resources)
• group:artifact:version:sources - extract the sources JAR instead
• group:artifact - look up the version from gradle/libs.versions.toml first
• group:artifact:sources - look up the version, then extract the sources JAR

Step 0 - Resolve version if omitted

If the version field is missing or the classifier is sources in the third position, look it up from gradle/libs.versions.toml before proceeding.

Search the toml for the group+artifact pair in the [libraries] section:

grep -n '<group>\|<artifact>' gradle/libs.versions.toml

The entry will look like:

some-alias = { module = "group:artifact", version = "1.2.3" }
# or with a version ref:
some-alias = { module = "group:artifact", version.ref = "some-version" }

If it uses version.ref, look up the ref in the [versions] section:

grep 'some-version' gradle/libs.versions.toml

Use the resolved version string. If not found in the toml, report clearly and stop.

Extraction target

Always extract into the project's build directory:

build/dependency-browser/<group>/<artifact>/<version>/

or for sources:

build/dependency-browser/<group>/<artifact>/<version>-sources/

Steps

1 - Check if already extracted

ls build/dependency-browser/<group>/<artifact>/<version>[-sources]/ 2>/dev/null

If files are listed, report the extraction dir and stop - do not re-extract.

2 - Locate the JAR in the Gradle cache

The local Gradle cache lives at ~/.gradle/caches/modules-2/files-2.1/. Search it:

# Main JAR
find ~/.gradle/caches/modules-2/files-2.1/<group>/<artifact>/<version> \
     -name "<artifact>-<version>.jar" ! -name "*sources*" ! -name "*javadoc*" \
     2>/dev/null

# Sources JAR
find ~/.gradle/caches/modules-2/files-2.1/<group>/<artifact>/<version> \
     -name "<artifact>-<version>-sources.jar" \
     2>/dev/null