Getting Started

Quick Start

Get your app deployed to any cloud in under 10 minutes. No YAML wrangling, no cloud console clicking — just one command or slash command in Claude Code.

Prerequisites

Node.js 22+ (for the frontend)
Python 3.12+ (for the tools)
Docker (for building and testing images)
Git
Claude Code CLI (for slash commands)

Installation

Clone the repo and install Python dependencies:

bash

git clone https://github.com/yashs33244/devops-agent
cd devops-agent
pip install -r requirements.txt

Your first deploy

The fastest path is through Claude Code slash commands. Open the project in Claude Code and follow these steps:

Open in Claude Code

Navigate to your devops-agent directory and open Claude Code. Pilot's CLAUDE.md is loaded automatically.

Type "/deploy"

Run the /deploy slash command. Pilot will start gathering requirements.

Answer the prompts

Pilot asks for: service name, GitHub repo URL, cloud provider (aws / gcp / azure), region, environment (dev / staging / prod), and optional KEDA scale-to-zero.

Pilot generates everything

Dockerfile + Terraform + Helm chart + CI/CD workflows + ESO secret manifests are written to your workspace. Every file is linted and validated before being declared ready.

Push to GitHub — CI runs automatically

The generated CI workflow triggers on push. On merge to main, CD deploys to your cluster via helm upgrade. No manual steps.

Or run directly

Bypass Claude Code and call the workflow orchestrator directly:

bash

python3 tools/workflow.py \
  --repo https://github.com/your-org/your-app \
  --service my-service \
  --cloud aws \
  --env dev \
  --with-keda

For individual steps, use the specific tool directly. Example — generate only Terraform:

bash

python3 tools/terraform_gen.py \
  --cloud aws \
  --service my-service \
  --use-case web_app \
  --region us-east-1 \
  --env dev

What gets generated

Every run of workflow.py or /deploy produces:

FILE / PATH	DESCRIPTION
Dockerfile	Multi-stage, nonroot, distroless base
terraform/main.tf	VPC, cluster, registry (AWS / GCP / Azure)
terraform/variables.tf	Parameterized for dev / staging / prod
helm/Chart.yaml	Production Helm chart with security contexts
helm/values.yaml	Resource limits, probes, autoscaling
.github/workflows/ci.yml	Lint + test + build on every push
.github/workflows/cd.yml	Push to registry + helm upgrade on merge
secrets/eso-manifests/	External Secrets Operator manifests
helm/templates/keda-scaler.yaml	KEDA HTTPScaledObject (if --with-keda)

Next steps

Meet the agents →All slash commands →Secrets management →