Pulumi Automation Api

If you're tired of chaining together pulumi CLI commands with bash scripts or need to orchestrate multiple stacks programmatically, this skill covers Automation API patterns. It walks through the LocalWorkspace API, inline vs local source programs, and practical multi-stack orchestration including sequential deploys, parallel operations, and passing outputs between stacks. The choice between inline and local source is well explained: inline for single-team ownership and simpler artifacts, local for separating concerns between platform and app teams. Good coverage of error handling, configuration management, and when not to bother with this complexity. Most useful if you're building self-service infrastructure portals or need reliable sequencing across dependent infrastructure layers.

skills.sh installs: 1.2K
GitHub stars: 79
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add pulumi/agent-skills --skill pulumi-automation-api --agent claude-code

Installs into .claude/skills of the current project.

Files

Pulumi Automation API

When to Use This Skill

Invoke this skill when:

Orchestrating deployments across multiple Pulumi stacks
Embedding Pulumi operations in custom applications
Building self-service infrastructure platforms
Replacing fragile Bash/Makefile orchestration scripts
Creating custom CLIs for infrastructure management
Building web applications that provision infrastructure

What is Automation API

Automation API provides programmatic access to Pulumi operations. Instead of running pulumi up from the CLI, you call functions in your code that perform the same operations.

import * as automation from "@pulumi/pulumi/automation";

// Create or select a stack
const stack = await automation.LocalWorkspace.createOrSelectStack({
    stackName: "dev",
    projectName: "my-project",
    program: async () => {
        // Your Pulumi program here
    },
});

// Run pulumi up programmatically
const upResult = await stack.up({ onOutput: console.log });
console.log(`Update summary: ${JSON.stringify(upResult.summary)}`);