# prb ai-system command reference

Manage AI systems. This page documents **7 commands** under `prb ai-system`.

Flags and examples below come from the command definitions. A **Required** flag is explicitly marked required by Cobra; an unmarked flag can still be needed by runtime validation or a non-interactive workflow. Empty strings and empty lists are registered defaults, not sample values.

Every command also inherits the [global flags](/docs/developers/cli/commands#global-flags). Run `prb <command> --help` to check your installed version. Replace placeholder IDs and names in source examples before running them. Return to the [complete CLI command reference](/docs/developers/cli/commands) to browse another command.

## Commands

| Command                                           | Description                                           | Usage                       | Source                                                                                                     |
| ------------------------------------------------- | ----------------------------------------------------- | --------------------------- | ---------------------------------------------------------------------------------------------------------- |
| [`prb ai-system`](#prb-ai-system)                 | Manage AI systems.                                    | `prb ai-system <command>`   | [View implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/aisystem/aisystem.go#L35)        |
| [`prb ai-system create`](#prb-ai-system-create)   | Create a new AI system.                               | `prb ai-system create`      | [View implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/aisystem/create/create.go#L81)   |
| [`prb ai-system delete`](#prb-ai-system-delete)   | Delete an AI system.                                  | `prb ai-system delete <id>` | [View implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/aisystem/delete/delete.go#L43)   |
| [`prb ai-system list`](#prb-ai-system-list)       | List AI systems in an organization.                   | `prb ai-system list`        | [View implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/aisystem/list/list.go#L79)       |
| [`prb ai-system publish`](#prb-ai-system-publish) | Publish the AI system register as a document version. | `prb ai-system publish`     | [View implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/aisystem/publish/publish.go#L83) |
| [`prb ai-system update`](#prb-ai-system-update)   | Update an AI system.                                  | `prb ai-system update <id>` | [View implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/aisystem/update/update.go#L75)   |
| [`prb ai-system view`](#prb-ai-system-view)       | View an AI system.                                    | `prb ai-system view <id>`   | [View implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/aisystem/view/view.go#L98)       |

## prb ai-system

Manage AI systems.

### Usage

```text
prb ai-system <command>
```

[View command implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/aisystem/aisystem.go#L35).

## prb ai-system create

Create a new AI system.

### Usage

```text
prb ai-system create
```

Accepts no positional arguments.

### Flags

| Flag                          | Type         | Default | Required | Description                                                       |
| ----------------------------- | ------------ | ------- | -------- | ----------------------------------------------------------------- |
| `--autonomy-level`            | string       | `""`    | —        | Autonomy level                                                    |
| `--company-role`              | string array | `[]`    | —        | Company role: PROVIDER, DEPLOYER, USER, DEVELOPER (repeatable)    |
| `--data-sources-and-type`     | string       | `""`    | —        | Data sources and type                                             |
| `--deployment-date`           | string       | `""`    | —        | Deployment date (RFC3339)                                         |
| `--human-oversight-mechanism` | string       | `""`    | —        | Human oversight mechanism                                         |
| `--intended-use-cases`        | string       | `""`    | —        | Intended use cases                                                |
| `--key-stakeholders`          | string       | `""`    | —        | Key stakeholders                                                  |
| `--last-review-date`          | string       | `""`    | —        | Last review date (RFC3339)                                        |
| `--name`                      | string       | `""`    | —        | System name (required)                                            |
| `--next-review-date`          | string       | `""`    | —        | Next review date (RFC3339)                                        |
| `--notes`                     | string       | `""`    | —        | Notes                                                             |
| `--org`                       | string       | `""`    | —        | Organization ID                                                   |
| `--owner`                     | string       | `""`    | —        | Owner profile ID                                                  |
| `--purpose`                   | string       | `""`    | —        | Purpose / business goals                                          |
| `--risk-classification`       | string       | `""`    | —        | Risk classification: HIGH_RISK, LIMITED, MINIMAL, GPAI (required) |
| `--source`                    | string       | `""`    | —        | Source                                                            |
| `--status`                    | string       | `""`    | —        | Status: ACTIVE, IN_DEVELOPMENT, DECOMMISSIONED (required)         |
| `--version`                   | string       | `""`    | —        | System version                                                    |

### Examples

```bash
# Create an AI system interactively
prb ai-system create

# Create non-interactively
prb ai-system create --name "Support Chatbot" --status ACTIVE --risk-classification MINIMAL
```

[View command implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/aisystem/create/create.go#L81).

## prb ai-system delete

Delete an AI system.

### Usage

```text
prb ai-system delete <id>
```

Requires 1 positional argument.

### Flags

| Flag          | Type    | Default | Required | Description              |
| ------------- | ------- | ------- | -------- | ------------------------ |
| `--yes`, `-y` | boolean | `false` | —        | Skip confirmation prompt |

[View command implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/aisystem/delete/delete.go#L43).

## prb ai-system list

List AI systems in an organization.

### Usage

```text
prb ai-system list
```

Accepts no positional arguments.

### Flags

| Flag                    | Type    | Default  | Required | Description                                                       |
| ----------------------- | ------- | -------- | -------- | ----------------------------------------------------------------- |
| `--after`               | string  | `""`     | —        | Cursor from the previous page (the Next cursor line)              |
| `--json`                | boolean | `false`  | —        | Output JSON (same as --output json)                               |
| `--limit`, `-L`         | integer | `30`     | —        | Maximum number of AI systems to list                              |
| `--order-by`            | string  | `""`     | —        | Order by field (CREATED_AT, NAME, STATUS)                         |
| `--order-direction`     | string  | `"DESC"` | —        | Sort direction (ASC, DESC)                                        |
| `--org`                 | string  | `""`     | —        | Organization ID                                                   |
| `--output`, `-o`        | string  | `""`     | —        | Output format: json, table (default)                              |
| `--risk-classification` | string  | `""`     | —        | Filter by risk classification (HIGH_RISK, LIMITED, MINIMAL, GPAI) |
| `--status`              | string  | `""`     | —        | Filter by status (ACTIVE, IN_DEVELOPMENT, DECOMMISSIONED)         |

### Examples

```bash
# List AI systems in the default organization
prb ai-system list

# List active systems only
prb ai-system ls --status ACTIVE --output json
```

[View command implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/aisystem/list/list.go#L79).

## prb ai-system publish

Publish the AI system register as a document version.

### Usage

```text
prb ai-system publish
```

### Flags

| Flag         | Type         | Default | Required | Description                                                 |
| ------------ | ------------ | ------- | -------- | ----------------------------------------------------------- |
| `--approver` | string array | `[]`    | —        | Approver profile ID (can be repeated; ignored with --minor) |
| `--minor`    | boolean      | `false` | —        | Publish as a minor version (no approval flow)               |
| `--org`      | string       | `""`    | —        | Organization ID                                             |

### Examples

```bash
# Publish the AI system register
prb ai-system publish --org ORG_ID

# Publish with approvers
prb ai-system publish --org ORG_ID --approver PROFILE_ID1 --approver PROFILE_ID2
```

[View command implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/aisystem/publish/publish.go#L83).

## prb ai-system update

Update an AI system.

### Usage

```text
prb ai-system update <id>
```

Requires 1 positional argument.

### Flags

| Flag                          | Type         | Default | Required | Description               |
| ----------------------------- | ------------ | ------- | -------- | ------------------------- |
| `--autonomy-level`            | string       | `""`    | —        | Autonomy level            |
| `--company-role`              | string array | `[]`    | —        | Company role (repeatable) |
| `--data-sources-and-type`     | string       | `""`    | —        | Data sources and type     |
| `--deployment-date`           | string       | `""`    | —        | Deployment date           |
| `--human-oversight-mechanism` | string       | `""`    | —        | Human oversight mechanism |
| `--intended-use-cases`        | string       | `""`    | —        | Intended use cases        |
| `--key-stakeholders`          | string       | `""`    | —        | Key stakeholders          |
| `--last-review-date`          | string       | `""`    | —        | Last review date          |
| `--name`                      | string       | `""`    | —        | System name               |
| `--next-review-date`          | string       | `""`    | —        | Next review date          |
| `--notes`                     | string       | `""`    | —        | Notes                     |
| `--owner`                     | string       | `""`    | —        | Owner profile ID          |
| `--purpose`                   | string       | `""`    | —        | Purpose                   |
| `--risk-classification`       | string       | `""`    | —        | Risk classification       |
| `--source`                    | string       | `""`    | —        | Source                    |
| `--status`                    | string       | `""`    | —        | Status                    |
| `--version`                   | string       | `""`    | —        | System version            |

[View command implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/aisystem/update/update.go#L75).

## prb ai-system view

View an AI system.

### Usage

```text
prb ai-system view <id>
```

Requires 1 positional argument.

### Flags

| Flag             | Type    | Default | Required | Description                          |
| ---------------- | ------- | ------- | -------- | ------------------------------------ |
| `--json`         | boolean | `false` | —        | Output JSON (same as --output json)  |
| `--output`, `-o` | string  | `""`    | —        | Output format: json, table (default) |

[View command implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/aisystem/view/view.go#L98).