# Opsh

## Docs

- [Configure opsh](https://docs.opsh.dxu.one/configuration/overview.md): Complete reference for every setting in ~/.opsh/config.json — shell preference, execution behavior, history limits, and AI provider options.
- [AI Setup](https://docs.opsh.dxu.one/configuration/providers.md): Connect Opsh to OpenAI, Anthropic, Gemini, OpenRouter, or a local Ollama model. Configure API keys, base URLs, and active provider.
- [Installation](https://docs.opsh.dxu.one/installation.md): Install Opsh with a single curl command. The installer downloads the latest binary, places it in ~/.opsh/bin, and adds Opsh to your shell startup files.
- [Welcome to opsh](https://docs.opsh.dxu.one/introduction.md): Opsh is a natural-language shell adapter for macOS and Linux that translates plain English into shell commands using your choice of AI provider.
- [Quickstart](https://docs.opsh.dxu.one/quickstart.md): Install Opsh, choose an AI provider, and run your first natural-language shell command — all in under five minutes on macOS or Linux.
- [Safety Overview](https://docs.opsh.dxu.one/safety/overview.md): Opsh analyzes every generated command before showing it to you, blocks catastrophic patterns outright, and always asks before running anything.
- [Command Risk Levels](https://docs.opsh.dxu.one/safety/risk-levels.md): Learn how Opsh classifies every generated command as safe, caution, or dangerous — and what that means for confirmation and warp mode.
- [Common Problems & Fixes](https://docs.opsh.dxu.one/troubleshooting.md): Fix the most common Opsh problems: terminal startup failures, API key errors, slow responses, unexpected warp mode behavior, and more.
- [Uninstallation](https://docs.opsh.dxu.one/uninstall.md): Remove Opsh from macOS or Linux, including the binary and shell rc integration, while keeping or fully deleting your configuration file.
- [Commands](https://docs.opsh.dxu.one/usage/commands.md): Complete reference for Opsh meta commands (prefixed with !) and CLI flags — control modes, view history, and manage configuration from the REPL.
- [One-shot Mode](https://docs.opsh.dxu.one/usage/oneshot.md): Pass a natural-language request directly to Opsh as a command-line argument to generate and run a single shell command without opening the interactive REPL.
- [How to use opsh](https://docs.opsh.dxu.one/usage/repl.md): Learn how to use the Opsh interactive shell — type natural-language requests, review AI-generated commands, and control execution from a persistent prompt.
- [Warp Mode](https://docs.opsh.dxu.one/usage/warp-mode.md): Warp mode auto-runs safe and caution commands, then uses AI to summarize output in plain English — no confirmation prompt needed for routine tasks.