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

# tag

> tag コマンドを使用して、Diversion でタグを作成、一覧表示、変更、削除し、効率的にバージョン管理を行います。

Diversion では、特定のコミットを参照しやすくするためにコミットにタグを付けることができます。タグはデスクトップアプリからも管理できます — [タグガイド](/ja/basic/tags) を参照してください。

リポジトリ内のすべてのタグを一覧表示するには：

```bash theme={null}
dv tag [--json]
```

スクリプト用途などには `--json` を指定して JSON 出力を利用してください。

新しいタグを作成するには：

```bash theme={null}
dv tag -c <name> [-a <description>] [--ref <commit_id>]
```

上記のコマンドは、名前 `<name>` で新しいタグを作成します。また、`[-a "Tag description"]` を指定してオプションで説明を追加できます。

`commit_id` を明示的に指定することもできますが、デフォルトでは現在のコミットにタグが付けられます。

タグ名には、文字、数字、および `.` `-` `_` `/` の文字を使用でき（スペースは不可）、最大128文字までです。説明は最大1024文字までです。

タグを削除するには：

```bash theme={null}
dv tag -d <tag_id> [-f]
```

タグIDはタグ名ではなく、Diversion のIDである必要があります。`dv tag` で確認するか、デスクトップアプリからコピーできます。`-f` は確認プロンプトをスキップします。

既存のタグを変更するには：

```bash theme={null}
dv tag -m <tag_id> [--name <new_name>] [-a <description>]
```

`[--name <new_name>]` はタグの名前を変更します。

`[-a <description>]` はタグの説明を更新します。