# okibi spec

> Edit a CLI's spec, or review a paused run's proposed spec

Generated from okibi 0.2.4. Every command also accepts `--agent`; see [Agent and CI mode](https://okibi.ai/docs/cli/agent-mode.md).

## okibi spec

Edit a CLI's spec, or review a paused run's proposed spec

```sh
okibi spec [command]
```

## okibi spec approve

Approve the proposed spec and start building

```sh
okibi spec approve <run> [flags]
```

Flags:

| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--api-url` | string | https://okibi.ai | Okibi API base URL |

## okibi spec edit

Edit a CLI's durable cli-spec.md and commit it to its repo.

Opens $EDITOR. If standard input is not a terminal, or --file is given, the new spec is read from there instead. Print the current spec with `okibi spec show <cli-name>`.

```sh
okibi spec edit <cli-name> [flags]
```

Flags:

| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--api-url` | string | https://okibi.ai | Okibi API base URL |
| `--file` | string |  | read the new spec from this file (use - for stdin) instead of $EDITOR |
| `--workspace` | string |  | workspace slug for this CLI (or OKIBI_WORKSPACE; ignored for workspace-locked keys) |

## okibi spec reject

Send the proposed spec back for another pass with feedback

```sh
okibi spec reject <run> --feedback "…" [flags]
```

Flags:

| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--api-url` | string | https://okibi.ai | Okibi API base URL |
| `--feedback` | string |  | what to change about the proposed spec |

## okibi spec show

Print a CLI's durable cli-spec.md, or a run's proposed spec with a run id

```sh
okibi spec show <cli-name> [run] [flags]
```

Flags:

| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--api-url` | string | https://okibi.ai | Okibi API base URL |
| `--workspace` | string |  | workspace slug for the CLI (or OKIBI_WORKSPACE; ignored for workspace-locked keys) |