Skip to main content
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:

​
Enabling warp mode

You have three ways to turn on warp mode: Toggle it in the REPL at any time:
Set it permanently in your config file (~/.opsh/config.json):
Enable it during initial setup:
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.
Warp mode skips the confirmation prompt for commands classified as safe or caution. Before enabling it, make sure you understand the 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.
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.