# atmos ci cache delete

Delete a CI cache entry by its exact key. Deleting a key that does not exist is a no-op.

> ⚠️ Experimental

:::info Runs locally
Like [`list`](/cli/commands/ci/cache/list), `delete` administers the cache over the provider's public API and works from your workstation as well as inside CI. It needs a GitHub token (`GITHUB_TOKEN` / `ATMOS_GITHUB_TOKEN`, or `gh auth login`) and a GitHub repository (resolved from `GITHUB_REPOSITORY` or your local `git` remote).
:::

**Configure the CI Cache**

Configure the cache in your `atmos.yaml`.

CI Cache Configuration Reference[Read more](/cli/configuration/ci/cache)

## Usage

```shell
atmos ci cache delete --key=<key>
```

## Examples

```shell
# Delete a specific cache entry
atmos ci cache delete --key="atmos-cache-linux-amd64-abc123"
```

## Flags

- **`--key` / `-k`**
  Exact cache key to delete. 
  **Required.**

## Environment Variables

- **`ATMOS_CI_CACHE_ENABLED`**
  Must be 
  `true`
   (or 
  `ci.cache.enabled: true`
   in 
  `atmos.yaml`
  ) for the command to run.
- **`ATMOS_CI_CACHE_KEY`**
  Overrides 
  `--key`
  .

## Related

- [`atmos ci cache list`](/cli/commands/ci/cache/list) - List cache entries
- [CI Cache Configuration](/cli/configuration/ci/cache) - Configure the cache
