---
component: artifact-cache
version: "1.7"
slug: artifact-cache/index
canonical_url: "https://docs.develocity.ai/artifact-cache/1.7/"
title: "Develocity Artifact Cache CLI"
description: "Caches the downloads that build tools, package managers, test runners, and code analysis tools need, plus Gradle build initialization inputs, on Edge nodes."
keywords:
  - "Artifact Cache"
  - "Setup Cache"
status: current
---

<!-- llms-index: https://docs.develocity.ai/llms.txt -->

# Develocity Artifact Cache CLI

<a id="preamble"></a>

<a id="introduction"></a>

Develocity Artifact Cache CLI caches the downloads that build tools, package managers, test runners, and code analysis tools need, plus Gradle build initialization inputs, on Edge nodes. At the start of each CI job, the CLI restores these inputs from the nearest Edge node. The build proceeds without re-downloading dependencies from the WAN or re-running initialization steps.

<a id="key-capabilities"></a>

## Key Capabilities

*   **Dependency caching**: stores and restores what build tools, package managers, test runners, and code analysis tools download, from Edge nodes, reducing WAN downloads on CI
    
*   **Setup Cache**: caches Gradle build initialization inputs (compiled build scripts, resolved configurations, `buildSrc`, and included builds) to reduce startup time on cold CI agents
    
*   **CI-platform agnostic**: runs as shell commands in any CI environment
    
*   **Develocity integration**: reports Artifact Cache and Setup Cache metrics to Build Scan® via the Common Custom User Data plugins
    
*   **Edge-native**: uses Develocity Edge nodes as the persistent cache layer, with automatic Edge discovery via access key
    

> [!NOTE]
> Using Artifact Cache requires the Artifact Cache entitlement on your Develocity license. Using Setup Cache requires the Setup Cache entitlement. For questions about license entitlements, contact Develocity support.

<a id="in-this-section"></a>

## In This Section

User Manual

How the CLI works: operation flow, Edge discovery, and observability

*   [How It Works](https://docs.develocity.ai/artifact-cache/1.7/user-manual/)

Concepts

Understand the core objects the CLI works with

*   [Images](https://docs.develocity.ai/artifact-cache/1.7/concepts/images/)
*   [Maven Snapshot Dependencies](https://docs.develocity.ai/artifact-cache/1.7/concepts/maven-snapshots/)

Guides

Step-by-step CI platform setup and observability investigations

*   [GitHub Actions](https://docs.develocity.ai/artifact-cache/1.7/how-to/configure-github-actions/)
*   [Jenkins](https://docs.develocity.ai/artifact-cache/1.7/how-to/configure-jenkins/)
*   [Measure Cache Effectiveness](https://docs.develocity.ai/artifact-cache/1.7/how-to/measure-cache-effectiveness/)
*   [Reduce Repository Instability Impact](https://docs.develocity.ai/artifact-cache/1.7/how-to/reduce-repository-instability/)
*   [Trace a Dependency's Origin](https://docs.develocity.ai/artifact-cache/1.7/how-to/trace-dependency-origin/)

Reference

System requirements and CLI command reference

*   [Requirements](https://docs.develocity.ai/artifact-cache/1.7/reference/requirements/)
*   [CLI Commands](https://docs.develocity.ai/artifact-cache/1.7/reference/cli-commands/)

[

Download the CLI

Get the CLI JAR from an Edge node or your own repository

](https://docs.develocity.ai/artifact-cache/1.7/download-the-cli/)

[

Troubleshooting

Diagnose and resolve CLI-to-Edge compatibility check-in failures

](https://docs.develocity.ai/artifact-cache/1.7/troubleshooting/)

[

Release History

Changelog and version history

](https://docs.develocity.ai/artifact-cache/1.7/release-history/)