---
title: "plm releases"
description: "Release versioning"
---

{/* AUTO-GENERATED by packages/cli/scripts/generate-docs.ts — do not edit by hand. */}
## plm releases

Release versioning

**Usage**

```bash
plm releases
```

**Subcommands**

- [`list`](#plm-releases-list)
- [`create`](#plm-releases-create)
- [`compare`](#plm-releases-compare)
- [`get`](#plm-releases-get)
- [`notes`](#plm-releases-notes)
- [`rollback`](#plm-releases-rollback)

<details>
<summary>Agent-readable summary</summary>

```json
{
  "command": "plm releases",
  "description": "Release versioning",
  "arguments": [],
  "options": [],
  "subcommands": [
    "list",
    "create",
    "compare",
    "get",
    "notes",
    "rollback"
  ]
}
```

</details>

### plm releases list

**Usage**

```bash
plm releases list
```

**Options**

- `-f, --filter <kv...>` — key=value filters
- `--format <fmt>` — output format _(default: `"json"`)_

<details>
<summary>Agent-readable summary</summary>

```json
{
  "command": "plm releases list",
  "description": null,
  "arguments": [],
  "options": [
    {
      "flags": "-f, --filter <kv...>",
      "description": "key=value filters",
      "required": false,
      "default": null
    },
    {
      "flags": "--format <fmt>",
      "description": "output format",
      "required": false,
      "default": "json"
    }
  ],
  "subcommands": []
}
```

</details>

### plm releases create

**Usage**

```bash
plm releases create
```

**Options**

- `--file <path>`

<details>
<summary>Agent-readable summary</summary>

```json
{
  "command": "plm releases create",
  "description": null,
  "arguments": [],
  "options": [
    {
      "flags": "--file <path>",
      "description": "",
      "required": false,
      "default": null
    }
  ],
  "subcommands": []
}
```

</details>

### plm releases compare

**Usage**

```bash
plm releases compare
```

**Options**

- `-f, --filter <kv...>` — e.g., from=v1 to=v2
- `--format <fmt>` — output format _(default: `"json"`)_

<details>
<summary>Agent-readable summary</summary>

```json
{
  "command": "plm releases compare",
  "description": null,
  "arguments": [],
  "options": [
    {
      "flags": "-f, --filter <kv...>",
      "description": "e.g., from=v1 to=v2",
      "required": false,
      "default": null
    },
    {
      "flags": "--format <fmt>",
      "description": "output format",
      "required": false,
      "default": "json"
    }
  ],
  "subcommands": []
}
```

</details>

### plm releases get

**Usage**

```bash
plm releases get <version>
```

**Options**

- `--format <fmt>` — output format _(default: `"json"`)_

<details>
<summary>Agent-readable summary</summary>

```json
{
  "command": "plm releases get",
  "description": null,
  "arguments": [
    {
      "name": "version",
      "required": true,
      "variadic": false,
      "description": ""
    }
  ],
  "options": [
    {
      "flags": "--format <fmt>",
      "description": "output format",
      "required": false,
      "default": "json"
    }
  ],
  "subcommands": []
}
```

</details>

### plm releases notes

**Usage**

```bash
plm releases notes <version>
```

**Options**

- `--format <fmt>` — output format _(default: `"json"`)_

<details>
<summary>Agent-readable summary</summary>

```json
{
  "command": "plm releases notes",
  "description": null,
  "arguments": [
    {
      "name": "version",
      "required": true,
      "variadic": false,
      "description": ""
    }
  ],
  "options": [
    {
      "flags": "--format <fmt>",
      "description": "output format",
      "required": false,
      "default": "json"
    }
  ],
  "subcommands": []
}
```

</details>

### plm releases rollback

**Usage**

```bash
plm releases rollback <version>
```

**Options**

- `--file <path>` — rollback payload: \{ currentVersion, reason, ... \}
- `--format <fmt>` — output format _(default: `"json"`)_

<details>
<summary>Agent-readable summary</summary>

```json
{
  "command": "plm releases rollback",
  "description": null,
  "arguments": [
    {
      "name": "version",
      "required": true,
      "variadic": false,
      "description": ""
    }
  ],
  "options": [
    {
      "flags": "--file <path>",
      "description": "rollback payload: { currentVersion, reason, ... }",
      "required": false,
      "default": null
    },
    {
      "flags": "--format <fmt>",
      "description": "output format",
      "required": false,
      "default": "json"
    }
  ],
  "subcommands": []
}
```

</details>