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

# Terminal operations workspace

> Observe and safely operate deployments from a reconnectable terminal interface.

`infercrane ui` opens an interactive operations workspace backed by the same authenticated control-plane API and durable operations as the scriptable CLI.

```bash theme={"theme":{"light":"github-light-default","dark":"vesper"}}
infercrane ui
```

The workspace complements commands and JSON output. Use it for investigation and deliberate operator actions; use normal commands in automation, CI, redirected output, and agent workflows.

## Product views

| View           | What it answers                                                                         |
| -------------- | --------------------------------------------------------------------------------------- |
| Overview       | Is inference serving, what changed, and why?                                            |
| Operations     | What durable work is active, when will it retry, and can it be cancelled?               |
| Rollout        | Which revision is active, is there a candidate, and what did Release Guard decide?      |
| Performance    | What are latency, TTFT, throughput, errors, cold-start evidence, and benchmark history? |
| Infrastructure | Which provider adapter, targets, replicas, and immutable model artifact are involved?   |
| Scaling        | What are the bounds and why did capacity change?                                        |
| Events         | What persisted event occurred, when, and with what machine-readable payload?            |

Use `←` and `→` to change views, or press `1`–`7` to jump directly. Navigation uses compact labels on narrow terminals and adds a contextual workspace column on ultrawide terminals. On the Events view, use `j` and `k` to inspect full historical details. Old events remain visible but are separated from live health so historical failures do not look like current incidents.

## Safe actions

Press `Ctrl-K` or `:` to open the action palette. InferCrane only shows actions applicable to the selected deployment and persisted state.

Direct guarded actions include:

* cooperatively cancel an active durable operation
* evaluate Release Guard for the current candidate
* promote only when the current candidate has a persisted accepting Guard decision

Every mutation shows its impact, requires a second confirmation, uses an idempotency key, and queues a durable control-plane operation. Release Guard evaluation explicitly warns that measured candidate traffic may incur provider cost. Closing the terminal never cancels queued work.

Complex authoring remains a CLI handoff. The palette copies exact commands for test requests,
reproducible benchmarks, and semantic capacity plans. Candidate creation, rollback, rejection
reasons, deletion plans, and administrative workflows remain explicit CLI/spec operations where
inputs and diffs are easier to review.

<Warning>
  Promotion is unavailable when an evaluation is missing, rejecting, or belongs to a previous candidate. InferCrane never treats historical acceptance as permission to promote a new revision.
</Warning>

## Read-only environments

Start the same workspace with mutation controls disabled:

```bash theme={"theme":{"light":"github-light-default","dark":"vesper"}}
infercrane ui --read-only
```

The action palette retains copyable command handoffs but cannot construct API mutations. This is useful for shared incident sessions, demos, and restricted credentials. Server-side authorization remains authoritative in both modes.

## Reconnection

The control plane—not the terminal—owns deployment work. Quit, disconnect SSH, or close the laptop, then reopen:

```bash theme={"theme":{"light":"github-light-default","dark":"vesper"}}
infercrane ui
```

The workspace reconstructs itself from persisted deployments, operations, revisions, Guard evaluations, benchmarks, scaling decisions, and events. tmux is optional and InferCrane does not manage tmux sessions.

## Keyboard reference

| Key                   | Action                                           |
| --------------------- | ------------------------------------------------ |
| `←`, `h`, `Shift-Tab` | Previous product view                            |
| `→`, `l`, `Tab`       | Next product view                                |
| `1`–`7`               | Jump directly to a product view                  |
| `j`, `↓` / `k`, `↑`   | Select deployment, or event on the Events view   |
| `Ctrl-K`, `:`         | Open applicable action palette                   |
| `r`                   | Refresh immediately                              |
| `c`                   | Copy endpoint or active operation resume command |
| `?`                   | Toggle safety and keyboard help                  |
| `q`, `Ctrl-C`         | Close without cancelling operations              |

The workspace detects light and dark terminal backgrounds, adapts to narrow screens, requires an interactive TTY, and reconnects after transient API failures. For screen readers and logs, use `--output json` or the equivalent `status`, `events`, `explain`, and `operation` commands.