> ## Documentation Index
> Fetch the complete documentation index at: https://docs.opsh.dxu.one/llms.txt
> Use this file to discover all available pages before exploring further.

> Warp mode auto-runs safe and caution commands, then uses AI to summarize output in plain English — no confirmation prompt needed for routine tasks.

# Warp Mode

Warp mode changes how Opsh handles command execution and output. Instead of pausing for confirmation on every command, Opsh runs commands classified as `safe` or `caution` automatically, then passes the output back to the AI, which returns a plain-English summary of the result. This makes Opsh feel more like a conversational assistant than a command-line tool.

## What warp mode does

When warp mode is on:

* Commands classified as **safe** or **caution** run immediately without a confirmation prompt.
* After the command runs, Opsh sends the output to the AI, which summarizes the result in plain English.
* Commands classified as **dangerous** are not auto-run — Opsh shows a warning and stops.

The AI interpretation step replaces the raw terminal output with a concise summary. For example, if you ask "how much disk space am I using?", Opsh runs `df -h` and responds with something like:

```text theme={null}
Your disk is 62% full. The main volume has 189 GB used out of 494 GB total.
```

## Enabling warp mode

You have three ways to turn on warp mode:

**Toggle it in the REPL at any time:**

```text theme={null}
~ > !warp
```

**Set it permanently in your config file** (`~/.opsh/config.json`):

```json theme={null}
{
  "warpMode": true
}
```

**Enable it during initial setup:**

```bash theme={null}
opsh --init
```

The `--init` wizard asks whether you want to enable warp mode as part of configuration.

## What warp mode does not do

Warp mode will not auto-run commands classified as `dangerous`. If Opsh determines that a command poses a high risk — such as deleting files recursively or modifying system configuration — it shows a warning and exits rather than executing. This boundary is not configurable.

## Confirmations in warp mode

When warp mode is active, the `confirmByDefault` setting is effectively overridden: Opsh skips the `[Enter/y] run  [n] cancel` prompt for safe and caution commands. You will not be asked to confirm before the command runs.

## Toggling warp mode during a session

Use `!warp` in the REPL to switch warp mode on or off without restarting Opsh. The change is saved to your config file immediately so it persists to future sessions.

<Warning>
  Warp mode skips the confirmation prompt for commands classified as `safe` or `caution`. Before enabling it, make sure you understand the [risk levels](/safety/risk-levels) Opsh uses and are comfortable with how `caution` commands are classified. You can always disable warp mode with `!warp` if you want to review commands before they run.
</Warning>

<Tip>
  Use `!warp` mid-session to quickly toggle warp mode. This is useful if you're doing routine information-gathering tasks (where auto-execution is helpful) and then switch to something that warrants more care.
</Tip>