---
title: "plm boms"
description: "Manage BOMs"
---

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

Manage BOMs

**Usage**

```bash
plm boms
```

**Subcommands**

- [`list`](#plm-boms-list)
- [`get`](#plm-boms-get)
- [`create`](#plm-boms-create)
- [`update`](#plm-boms-update)
- [`delete`](#plm-boms-delete)
- [`items`](#plm-boms-items) — Manage BOM line items
- [`tree`](#plm-boms-tree)
- [`cost-analysis`](#plm-boms-cost-analysis)
- [`usage-hierarchy`](#plm-boms-usage-hierarchy)
- [`flattened`](#plm-boms-flattened)
- [`validate-line-ids`](#plm-boms-validate-line-ids)
- [`resolve`](#plm-boms-resolve)
- [`variants`](#plm-boms-variants) — Manage BOM variants
- [`override`](#plm-boms-override)

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

```json
{
  "command": "plm boms",
  "description": "Manage BOMs",
  "arguments": [],
  "options": [],
  "subcommands": [
    "list",
    "get",
    "create",
    "update",
    "delete",
    "items",
    "tree",
    "cost-analysis",
    "usage-hierarchy",
    "flattened",
    "validate-line-ids",
    "resolve",
    "variants",
    "override"
  ]
}
```

</details>

### plm boms list

**Usage**

```bash
plm boms list
```

**Options**

- `-f, --filter <kv...>` — key=value filters
- `--page <n>` — page number (1-based)
- `--limit <n>` — results per page
- `--offset <n>` — row offset (alternative to --page)
- `--format <fmt>` — output format _(default: `"json"`)_

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

```json
{
  "command": "plm boms list",
  "description": null,
  "arguments": [],
  "options": [
    {
      "flags": "-f, --filter <kv...>",
      "description": "key=value filters",
      "required": false,
      "default": null
    },
    {
      "flags": "--page <n>",
      "description": "page number (1-based)",
      "required": false,
      "default": null
    },
    {
      "flags": "--limit <n>",
      "description": "results per page",
      "required": false,
      "default": null
    },
    {
      "flags": "--offset <n>",
      "description": "row offset (alternative to --page)",
      "required": false,
      "default": null
    },
    {
      "flags": "--format <fmt>",
      "description": "output format",
      "required": false,
      "default": "json"
    }
  ],
  "subcommands": []
}
```

</details>

### plm boms get

**Usage**

```bash
plm boms get <bomId>
```

**Options**

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

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

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

</details>

### plm boms create

**Usage**

```bash
plm boms create
```

**Options**

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

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

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

</details>

### plm boms update

**Usage**

```bash
plm boms update <bomId>
```

**Options**

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

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

```json
{
  "command": "plm boms update",
  "description": null,
  "arguments": [
    {
      "name": "bomId",
      "required": true,
      "variadic": false,
      "description": ""
    }
  ],
  "options": [
    {
      "flags": "--file <path>",
      "description": "",
      "required": false,
      "default": null
    },
    {
      "flags": "--format <fmt>",
      "description": "output format",
      "required": false,
      "default": "json"
    }
  ],
  "subcommands": []
}
```

</details>

### plm boms delete

**Usage**

```bash
plm boms delete <bomId>
```

**Options**

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

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

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

</details>

### plm boms items

Manage BOM line items

**Usage**

```bash
plm boms items
```

**Subcommands**

- [`list`](#plm-boms-items-list)
- [`add`](#plm-boms-items-add)
- [`update`](#plm-boms-items-update)
- [`remove`](#plm-boms-items-remove)

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

```json
{
  "command": "plm boms items",
  "description": "Manage BOM line items",
  "arguments": [],
  "options": [],
  "subcommands": [
    "list",
    "add",
    "update",
    "remove"
  ]
}
```

</details>

#### plm boms items list

**Usage**

```bash
plm boms items list <bomId>
```

**Options**

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

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

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

</details>

#### plm boms items add

**Usage**

```bash
plm boms items add <bomId>
```

**Options**

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

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

```json
{
  "command": "plm boms items add",
  "description": null,
  "arguments": [
    {
      "name": "bomId",
      "required": true,
      "variadic": false,
      "description": ""
    }
  ],
  "options": [
    {
      "flags": "--file <path>",
      "description": "",
      "required": false,
      "default": null
    },
    {
      "flags": "--format <fmt>",
      "description": "output format",
      "required": false,
      "default": "json"
    }
  ],
  "subcommands": []
}
```

</details>

#### plm boms items update

**Usage**

```bash
plm boms items update <bomId> <itemId>
```

**Options**

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

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

```json
{
  "command": "plm boms items update",
  "description": null,
  "arguments": [
    {
      "name": "bomId",
      "required": true,
      "variadic": false,
      "description": ""
    },
    {
      "name": "itemId",
      "required": true,
      "variadic": false,
      "description": ""
    }
  ],
  "options": [
    {
      "flags": "--file <path>",
      "description": "",
      "required": false,
      "default": null
    },
    {
      "flags": "--format <fmt>",
      "description": "output format",
      "required": false,
      "default": "json"
    }
  ],
  "subcommands": []
}
```

</details>

#### plm boms items remove

**Usage**

```bash
plm boms items remove <bomId> <itemId>
```

**Options**

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

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

```json
{
  "command": "plm boms items remove",
  "description": null,
  "arguments": [
    {
      "name": "bomId",
      "required": true,
      "variadic": false,
      "description": ""
    },
    {
      "name": "itemId",
      "required": true,
      "variadic": false,
      "description": ""
    }
  ],
  "options": [
    {
      "flags": "--format <fmt>",
      "description": "output format",
      "required": false,
      "default": "json"
    }
  ],
  "subcommands": []
}
```

</details>

### plm boms tree

**Usage**

```bash
plm boms tree <bomId>
```

**Options**

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

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

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

</details>

### plm boms cost-analysis

**Usage**

```bash
plm boms cost-analysis <bomId>
```

**Options**

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

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

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

</details>

### plm boms usage-hierarchy

**Usage**

```bash
plm boms usage-hierarchy <bomId>
```

**Options**

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

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

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

</details>

### plm boms flattened

**Usage**

```bash
plm boms flattened <bomId>
```

**Options**

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

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

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

</details>

### plm boms validate-line-ids

**Usage**

```bash
plm boms validate-line-ids <bomId>
```

**Options**

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

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

```json
{
  "command": "plm boms validate-line-ids",
  "description": null,
  "arguments": [
    {
      "name": "bomId",
      "required": true,
      "variadic": false,
      "description": ""
    }
  ],
  "options": [
    {
      "flags": "--format <fmt>",
      "description": "output format",
      "required": false,
      "default": "json"
    }
  ],
  "subcommands": []
}
```

</details>

### plm boms resolve

**Usage**

```bash
plm boms resolve <bomId>
```

**Options**

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

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

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

</details>

### plm boms variants

Manage BOM variants

**Usage**

```bash
plm boms variants
```

**Subcommands**

- [`list`](#plm-boms-variants-list)
- [`create`](#plm-boms-variants-create)
- [`delete`](#plm-boms-variants-delete)

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

```json
{
  "command": "plm boms variants",
  "description": "Manage BOM variants",
  "arguments": [],
  "options": [],
  "subcommands": [
    "list",
    "create",
    "delete"
  ]
}
```

</details>

#### plm boms variants list

**Usage**

```bash
plm boms variants list <bomId>
```

**Options**

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

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

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

</details>

#### plm boms variants create

**Usage**

```bash
plm boms variants create <bomId>
```

**Options**

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

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

```json
{
  "command": "plm boms variants create",
  "description": null,
  "arguments": [
    {
      "name": "bomId",
      "required": true,
      "variadic": false,
      "description": ""
    }
  ],
  "options": [
    {
      "flags": "--file <path>",
      "description": "",
      "required": false,
      "default": null
    },
    {
      "flags": "--format <fmt>",
      "description": "output format",
      "required": false,
      "default": "json"
    }
  ],
  "subcommands": []
}
```

</details>

#### plm boms variants delete

**Usage**

```bash
plm boms variants delete <bomId> <variantId>
```

**Options**

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

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

```json
{
  "command": "plm boms variants delete",
  "description": null,
  "arguments": [
    {
      "name": "bomId",
      "required": true,
      "variadic": false,
      "description": ""
    },
    {
      "name": "variantId",
      "required": true,
      "variadic": false,
      "description": ""
    }
  ],
  "options": [
    {
      "flags": "--format <fmt>",
      "description": "output format",
      "required": false,
      "default": "json"
    }
  ],
  "subcommands": []
}
```

</details>

### plm boms override

**Usage**

```bash
plm boms override <bomId> <variantId>
```

**Options**

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

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

```json
{
  "command": "plm boms override",
  "description": null,
  "arguments": [
    {
      "name": "bomId",
      "required": true,
      "variadic": false,
      "description": ""
    },
    {
      "name": "variantId",
      "required": true,
      "variadic": false,
      "description": ""
    }
  ],
  "options": [
    {
      "flags": "--file <path>",
      "description": "",
      "required": false,
      "default": null
    },
    {
      "flags": "--format <fmt>",
      "description": "output format",
      "required": false,
      "default": "json"
    }
  ],
  "subcommands": []
}
```

</details>