> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clickwheel.fm/llms.txt
> Use this file to discover all available pages before exploring further.

# Playlists

> clickwheel Playlists commands and their options.

## `delete`

```bash theme={null}
clickwheel delete [OPTIONS] PLAYLIST_NAME
```

Delete a saved playlist.

**Examples**

```bash theme={null}
# Delete a playlist (asks to confirm)
clickwheel delete road-trip
```

<ParamField path="playlist_name" type="string" required>
  Playlist to delete
</ParamField>

<ParamField path="--force, -f" type="boolean">
  Skip confirmation
</ParamField>

## `edit`

```bash theme={null}
clickwheel edit [OPTIONS] [PLAYLIST_NAME]
```

Add or remove artists or individual tracks from a playlist.

**Examples**

```bash theme={null}
# Add an artist
clickwheel edit road-trip --add "Nirvana"

# Remove an artist
clickwheel edit road-trip --remove "Beastie Boys"

# Set the description
clickwheel edit road-trip -d "Windows down"
```

<ParamField path="playlist_name" type="string" default="ipod">
  Playlist to edit
</ParamField>

<ParamField path="--add, -a" type="string" default="[]">
  Artist to add
</ParamField>

<ParamField path="--remove, -r" type="string" default="[]">
  Artist to remove
</ParamField>

<ParamField path="--add-track" type="string" default="[]">
  Track path to add (repeatable)
</ParamField>

<ParamField path="--remove-track" type="string" default="[]">
  Track path to remove (repeatable)
</ParamField>

<ParamField path="--description, -d" type="string">
  Set the playlist description
</ParamField>

<ParamField path="--no-scan" type="boolean">
  Skip automatic library scan
</ParamField>

## `heal`

```bash theme={null}
clickwheel heal [OPTIONS] PLAYLIST_NAME
```

Drop playlist references to tracks no longer on disk.

Uses the missing-since flag set by `clickwheel scan`. Run a scan
first if you want freshness; pass --no-scan to skip the autoscan
if you've already scanned recently.

**Examples**

```bash theme={null}
# Drop references to files no longer on disk
clickwheel heal road-trip
```

<ParamField path="playlist_name" type="string" required>
  Playlist to heal
</ParamField>

<ParamField path="--no-scan" type="boolean">
  Skip automatic library scan
</ParamField>

## `playlist`

```bash theme={null}
clickwheel playlist [OPTIONS] [NAME]
```

Show your saved playlists.

**Examples**

```bash theme={null}
# List saved playlists
clickwheel playlist

# Show one playlist's tracks
clickwheel playlist road-trip
```

<ParamField path="name" type="string">
  Playlist name to show details
</ParamField>