devops-utils

A set of utility tools for DevOps, built around a dependency-free core exposed through several optional surfaces: a CLI, an MCP server, agent tools, a Claude Code plugin, a TUI, and a Qt UI.

Two things it does today:

• Azure DevOps, made scriptable and agent-friendly — work items, builds, repositories and pull requests over plain REST, on cloud and on-prem alike, with clean JSON on stdout and a human confirmation in front of every write.

• Kubernetes manifest sanitizing — mask every Secret value so a manifest can be pasted into a ticket, a chat, or an LLM prompt.

Nothing has to be installed to try it:

uvx --from "devops-utils[azure]" devops-utils azdo list --project MyProject --mine

Start with Install and configure, then pick the guide that matches what you are doing.

User guide

• Install and configure
  • The fastest path: no install at all
  • Installing it properly
  • Configuring Azure DevOps access
  • Checking it works
• Azure DevOps from the command line
  • Two rules worth knowing first
  • Finding work
  • Changing work
  • Diagnosing a failed pipeline
  • Searching repositories
  • Pull requests
  • Scripting recipes
  • The same operations elsewhere
• Bulk work items with a plan file
  • The shape of a plan
  • Worked example: a feature with its stories
  • Worked example: a bulk triage sweep
  • Reading the results
  • Notes that save time
  • The same thing from an agent
• Sanitize Kubernetes manifests
  • What it does
  • Use cases
  • Options
  • From an agent or the MCP server
• Wire it into an AI agent
  • One command to set it all up
  • What gets installed
  • Registering the MCP server
  • Use it as a Claude Code plugin
  • Point issue-tracker skills at Azure DevOps
  • Without an agent framework

Agent guides

• Domain Docs
  • Before exploring, read these
  • File structure
  • Use the glossary’s vocabulary
  • Flag ADR conflicts
• Azure DevOps work-item tools
  • Configuration (no machine credentials)
  • Human-in-the-loop (MCP writes)
  • Human-in-the-loop (CLI writes)
  • Surfaces
  • References (link / azdo_add_work_item_link)
  • Hierarchy (parent/child)
  • Area path / iteration path
  • Custom fields
  • Scheduling fields (start / target / due date, effort)
  • Work-item research filters
  • Repo search (three tiers)
  • Builds
  • Pull-request comments
• Issue tracker: GitHub
  • Conventions
  • When a skill says “publish to the issue tracker”
  • When a skill says “fetch the relevant ticket”
• Triage Labels

API reference

• devops_utils package
  • Subpackages
  • Module contents

Indices and tables

• Index

• Module Index

• Search Page