wingetCollections
  • Auto
  • Search
  • Awesome Collections
  • Awesome Programs
  • My Favorite Collections
  • My Collections
  • Account / Settings
  • Terms of Service
  • Privacy
  • About

© 2026 winget.ragerworks.com

Loading...
Install dops using Winget - wingetCollections
  1. Go back
  2. Packages
  3. dops
dops logo

dops RunDops

cli devops operations runbooks terminal tui
Use this command to install dops:
winget install --id=RunDops.dops -e

dops is a terminal UI (TUI) and web-based tool designed for browsing, parameterizing, and executing operational runbooks. It streamlines script execution by organizing runbooks into catalogs with typed parameters, risk controls, and encrypted storage.

Key Features:

  • Interactive TUI with catalog navigation, metadata panels, live output, and wizard-driven parameter input.
  • Web UI accessible via dops open, offering browser-based execution with real-time log streaming.
  • Catalog support for organizing runbooks locally or importing from Git repositories.
  • Encrypted vault storage for secure parameter management using age encryption.
  • MCP server integration to expose runbooks as tools for AI agents.

Audience & Benefit: Ideal for DevOps and platform engineering teams seeking a consistent, safe method for running operational scripts. dops provides a unified interface for script execution, reducing tribal knowledge dependency and enhancing security with risk controls and encrypted credentials.

Installation can be done via winget for Windows users, ensuring easy setup across different environments.

README

GitHub Release Go Version License Tests Security

the do(ops) cli

A browsable catalog of automation scripts that operators can select, parameterize, and execute directly from the terminal.

Try the Live Demo · Documentation · Report Bug · Request Feature

Also available in the browser: dops open
Or let AI agents run your runbooks: dops mcp serve

Table of Contents

<a href="#about">About</a>
<a href="#features">Features</a>
<a href="#installation">Installation</a>
<a href="#quick-start">Quick Start</a>
<a href="#themes">Themes</a>
<a href="#web-ui">Web UI</a>
<a href="#mcp-integration">MCP Integration</a>
<a href="#keyboard-shortcuts">Keyboard Shortcuts</a>
<a href="#shell-completion">Shell Completion</a>
<a href="#development">Development</a>
<a href="#getting-help">Getting Help</a>
<a href="#license">License</a>

About

dops is built for DevOps and platform engineering teams who need a consistent, safe way to run operational scripts. Instead of scattered shell scripts with tribal knowledge, dops organizes them into browsable catalogs with built-in parameter management, risk controls, and encrypted credential storage.

(back to top)

Versions
0.13.1
0.13.0
0.10.0
Website
github.com
License
Last updated
4/9/2026
Download latest version

Features

  • Interactive TUI — sidebar catalog tree, metadata panel, live output pane, and wizard-driven parameter input
  • Web UI — browser-based interface via dops open with real-time log streaming
  • Catalog system — organize runbooks locally or install shared catalogs from git repositories
  • Runbook aliases — short names for frequently used runbooks (dops run deploy instead of full IDs)
  • Risk controls — confirmation gates for high/critical risk runbooks, per-catalog risk policies
  • Encrypted vault — saved parameters encrypted with age (X25519 + ChaCha20-Poly1305)
  • Smart parameter input — saved values auto-applied, only prompts for what's needed
  • Live execution — real-time stdout/stderr streaming with scroll, search, and text selection
  • Execution history — persistent audit trail across TUI, CLI, Web, and MCP with dops history and web UI timeline
  • MCP server — expose runbooks as tools and skills to AI agents via the Model Context Protocol
  • MCP skills — injectable domain knowledge for AI agents via type: skill runbooks
  • 20 themes — github, dracula, gruvbox, nord, synthwave, unicorn, and more
  • CLI mode — run any runbook non-interactively with dops run --param key=value

(back to top)

Screenshots (click to expand)

TUI — Startup

TUI — Sidebar search

TUI — Wizard parameter input

TUI — Multi-select

TUI — Risk confirmation

TUI — Live execution output

TUI — Output search

TUI — Help overlay

Web UI — Catalog & parameter form

Web UI — Execution log

(back to top)

Installation

Quick install

curl -fsSL https://raw.githubusercontent.com/rundops/dops/main/install.sh | sh

Installs the latest binary to /usr/local/bin. Set DOPS_INSTALL_DIR to change the location.

Windows

winget install RunDops.dops

Or via Scoop:

scoop bucket add rundops https://github.com/rundops/scoop-bucket.git
scoop install dops

Or download the latest .zip from the releases page and add dops.exe to your PATH.

Homebrew

brew tap rundops/tap
brew install dops

Go

go install github.com/rundops/dops@latest

Docker (MCP server)

docker run -i -v ~/.dops:/data/dops ghcr.io/rundops/dops:latest

From source

git clone https://github.com/rundops/dops.git
cd dops
make build
./bin/dops

(back to top)

Quick Start

1. Initialize dops:

dops init

This creates ~/.dops/ with a default config and a sample hello-world runbook.

2. Launch the TUI:

dops

3. Navigate with arrow keys, run with Enter, fill in parameters, and confirm.

4. Or launch the web UI:

dops open

5. Install a shared catalog:

dops catalog install https://github.com/your-org/runbooks.git

Catalog structure

Catalogs are directories of runbooks. Each runbook is a folder with a runbook.yaml and a script.sh:

my-catalog/
├── check-health/
│   ├── runbook.yaml
│   └── script.sh
└── deploy-service/
    ├── runbook.yaml
    └── script.sh

Runbook example

name: check-health
version: 1.0.0
description: Runs health checks against a service endpoint
risk_level: medium
script: script.sh
parameters:
  - name: endpoint
    type: string
    required: true
    description: The endpoint to check
    scope: global

See the runbook guide for the full YAML schema, parameter types, and shell scripting conventions.

(back to top)

Themes

dops ships with 20 built-in themes. Default: github.

dops config set theme=dracula
githubdraculagruvboxnord
monokaisynthwavenightowlone-dark
kanagawaeverforestsolarizedespresso
unicornayuzenburncatppuccin-mocha
catppuccin-latterosepine-dawndooptokyomidnight

Set theme=rainbow for a random theme on every launch.

Custom themes go in ~/.dops/themes/.json. See the configuration reference for the theme schema.

(back to top)

Web UI

Launch a browser-based interface with dops open:

dops open              # opens http://localhost:3000
dops open --port 8080  # custom port
dops open --no-browser # start server without opening browser

The web UI provides:

  • Searchable catalog sidebar with risk indicators
  • Parameter forms with saved values pre-filled
  • Risk confirmation dialogs for high/critical operations
  • Real-time execution log streaming with ANSI color support
  • Full theme support — mirrors your configured dops theme

The SPA is embedded in the Go binary — no Node.js required at runtime. See the Web UI guide for details.

(back to top)

MCP Integration

dops exposes runbooks to AI agents via the Model Context Protocol. Each runbook becomes an MCP tool with a JSON Schema.

Claude Code

Add to .claude/settings.json:

{
  "mcpServers": {
    "dops": {
      "command": "dops",
      "args": ["mcp", "serve"]
    }
  }
}

Docker

# stdio transport
docker run -i -v ~/.dops:/data/dops ghcr.io/rundops/dops:latest

# HTTP transport
docker run -p 8080:8080 -v ~/.dops:/data/dops ghcr.io/rundops/dops:latest --transport http --port 8080

See the MCP guide for details on risk controls, resources, and streaming.

(back to top)

Keyboard Shortcuts

KeyAction
↑↓Navigate / scroll
EnterRun runbook
←→Collapse/expand catalog
/Search
TabSwitch pane focus
?Help overlay
ctrl+xStop execution
ctrl+shift+pCommand palette
qQuit

See the full keyboard reference for output pane controls, search navigation, and wizard shortcuts.

(back to top)

Shell Completion

# Bash
dops completion bash &gt; /etc/bash_completion.d/dops

# Zsh
dops completion zsh &gt; "${fpath[1]}/_dops"

# Fish
dops completion fish &gt; ~/.config/fish/completions/dops.fish

# PowerShell
dops completion powershell | Out-String | Invoke-Expression

(back to top)

Development

make build        # Build binary
make test         # Run tests
make vet          # Go vet
make lint         # golangci-lint
make web          # Build web UI (requires Node.js)
make screenshots  # Regenerate README hero screenshots and demo GIF (requires VHS)
make web-demo     # Record web UI demo GIF (requires Playwright + ffmpeg)
make docker       # Build Docker image
make ci           # Run CI checks (vet + test + build)

(back to top)

Getting Help

  • Documentation — guides, reference, and configuration
  • GitHub Issues — bug reports and feature requests
  • CLI Reference — all commands and flags

(back to top)

Support

If you find dops useful, consider buying me a coffee!

License

Distributed under the MIT License. See LICENSE for more information.

(back to top)