mcpField
P
package-usage

package-usage

github.com/pulumiCloud & DevOps78835 installsUpdated 3w ago
Repository

About package-usage

package-usage is a skill for querying Pulumi Cloud package versions and stack usage through the Pulumi API CLI. It helps teams find which stacks use a package and identify versions that lag behind the latest available version.

Key features

  1. 01Query package versions
  2. 02List organization-visible packages
  3. 03Retrieve package stack usage
  4. 04Compare stack and latest versions

Use cases

  1. 01Finding stacks using a named package
  2. 02Locating stacks on outdated versions
  3. 03Checking package use across an organization

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/pulumi/agent-skills --skill package-usage

After installing, type/package-usagein Claude Code to confirm it loaded.

Bundled filesagents/openai.yamluse_cases.yaml

Details

From the project README

API Reference

Query the Pulumi Cloud API with the pulumi api CLI subcommand. It authenticates with your existing Pulumi credentials and returns JSON.

Get the latest version of a package
pulumi api /api/registry/packages -F name={package_name} -F orgLogin={orgName}

Include orgLogin with the user's organization name. Omit -F name=... to list all packages visible to the organization (useful when the user has not named a specific package). The response contains a packages array. Each entry has a version field (the latest version), plus name, publisher, source, and packageStatus.

Get stack usage for a package
pulumi api /api/orgs/{orgName}/packages/usage -F packageName={package_name}

Replace {orgName} with the org name from context, PULUMI_ORG, or ask the user. packageName is required; query one package at a time.

Response fields:

  • packageName: The queried package
  • stacks: Array of {stackName, projectName, version, lastUpdate}
  • totalStacks: Total count

Workflow: Find outdated stacks

Use when the user wants to know which stacks are using an outdated version of a package.

  1. Get the latest version of the package
  2. Get stack usage for the package
  3. Compare each stack's version against the latest to identify outdated stacks
  4. Present results using the output format below

Output Format

Present results as a markdown table followed by a summary line:

| Project | Stack | Current Version | Latest Version | Status |
|---------|-------|-----------------|----------------|--------|
| my-app  | dev   | 6.40.0          | 6.52.0         | Outdated |
| my-app  | prod  | 6.52.0          | 6.52.0         | Up-to-date |

2 of 2 stacks checked. 1 outdated.

Out of scope: upgrading a specific stack

This skill identifies outdated stacks. It does not perform the upgrade itself. For actually bumping a package version in a project — editing package.json, requirements.txt, pyproject.toml, go.mod, or Pulumi.yaml, running pulumi preview, and reconciling the diff — hand off to the provider-upgrade skill.

Comments

Markdown supported