Skip to main content

CLI Documentation

Command-line interface for AI-powered Kubernetes operations

What is the CLI?​

The CLI provides command-line access to all DevOps AI Toolkit capabilities. It's a lightweight HTTP client designed for both AI agents and human operators who prefer terminal-based workflows.

Unlike MCP (limited to 8 high-level tools to minimize context window usage), the CLI exposes all REST API endpoints since there's no token cost per command. This means you get access to direct resource queries, logs, events, and more—all from a single binary with zero runtime dependencies.

Key benefits:

  • Single binary — No installation dependencies, just download and run
  • Cross-platform — Linux, macOS, Windows (amd64 + arm64)
  • Token efficient — Lower token overhead than MCP for AI agents
  • Complete API access — All 26 REST API endpoints (MCP exposes 8 tools)
  • Composable — Shell piping, scripting, and CI/CD integration

When to Use the CLI​

The CLI is ideal for:

  • Scripting and automation — Shell scripts, CI/CD pipelines, scheduled jobs
  • AI agent integration — Lower token overhead than MCP protocol
  • Direct API access — Commands for resources, logs, events, namespaces not available via MCP
  • Composability — Pipe output between commands, combine with other CLI tools

For details on DevOps AI Toolkit features (query, recommend, remediate, etc.), see the main documentation.

Getting Started​

Quick Start — Set up your AI agent to use the CLI

Documentation​

Setup​

Guides​

Architecture​

┌─────────────┐
│     CLI     │
└──────┬──────┘
       │ HTTP (GET/POST/DELETE)
       │ Bearer auth, JSON body
       ▼
┌─────────────────────┐
│ DevOps AI Toolkit   │
│ REST API Server     │
└─────────────────────┘

The CLI is a stateless HTTP client that reads the embedded OpenAPI spec and generates commands dynamically. All commands map directly to REST API endpoints.