Pp Cloud Run Admin

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/cloud/cloud-run-admin/SKILL.md,
     regenerated post-merge by tools/generate-skills/. Hand-edits here are
     silently overwritten on the next regen. Edit the library/ source instead.
     See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". -->

Google Cloud Run — Printing Press CLI

Prerequisites: Install the CLI

This skill drives the cloud-run-admin-pp-cli binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:

1. Install via the Printing Press installer. It defaults binaries to $HOME/.local/bin on macOS/Linux and %LOCALAPPDATA%\Programs\PrintingPress\bin on Windows:

   npx -y @mvanhorn/printing-press-library install cloud-run-admin --cli-only

2. Verify: cloud-run-admin-pp-cli --version
3. Ensure the reported install directory is on $PATH for the agent/runtime that will invoke this skill.

If the npx install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.6 or newer):

go install github.com/mvanhorn/printing-press-library/library/cloud/cloud-run-admin/cmd/cloud-run-admin-pp-cli@latest

If --version reports "command not found" after install, the runtime cannot see the binary directory on $PATH. Do not proceed with skill commands until verification succeeds.

When to Use This CLI

Use this CLI when an agent or script needs focused Cloud Run Admin API access without navigating the full gcloud surface. It is strongest for read-heavy inspection, local inventory sync, search, field-selected JSON, and workflows that correlate services, jobs, executions, revisions, tasks, and operations.

Unique Capabilities

These capabilities aren't available in any other tool for this API.

Agent-native Cloud Run operations

• services list — Lists Cloud Run services through the Admin API with agent-friendly JSON, compact output, and field selection.

  Use this when an agent needs a compact inventory of Cloud Run services in a project and region.

  cloud-run-admin-pp-cli services list projects/PROJECT_ID/locations/REGION --agent --select services.name,services.uri,nextPageToken

Local state and analysis

• sync — Syncs Cloud Run resources into a local SQLite store so services, jobs, revisions, executions, tasks, and operations can be searched without repeating every API call.

  Use this before offline search, SQL inspection, or repeated multi-resource analysis.

  cloud-run-admin-pp-cli sync --json

• search — Searches synced Cloud Run inventory locally or falls back to live API calls depending on the data-source mode.

  Use this when you need to locate Cloud Run resources by remembered fragments.

  cloud-run-admin-pp-cli search "api" --type services --json --select resource_type,title

• analytics — Runs local analysis against synced Cloud Run data for inventory and status-oriented questions.

  Use this after sync when the question is about trends or inventory health rather than a single resource.

  cloud-run-admin-pp-cli analytics --json

Workflow status checks

• workflow — Provides compound workflows that combine multiple Cloud Run Admin API operations into one operator-facing flow.

  Use this when the task spans more than one Cloud Run resource type.

  cloud-run-admin-pp-cli workflow --help

HTTP Transport

This CLI uses Chrome-compatible HTTP transport for browser-facing endpoints. It does not require a resident browser process for normal API calls.

Command Reference

cloud-run-admin-jobs — Manage cloud run admin jobs

• cloud-run-admin-pp-cli cloud-run-admin-jobs create — Creates a Job.
• cloud-run-admin-pp-cli cloud-run-admin-jobs list — Lists Jobs.
• cloud-run-admin-pp-cli cloud-run-admin-jobs run — Triggers creation of a new Execution of this Job.

executions — Manage executions

operations — Manage operations

• cloud-run-admin-pp-cli operations list — Lists operations that match the specified filter in the request. If the server doesn't support this method, it...
• cloud-run-admin-pp-cli operations wait — Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the...

services — Manage services

• cloud-run-admin-pp-cli services create — Creates a new Service in a given project and location.
• cloud-run-admin-pp-cli services get-iam-policy — Gets the IAM Access Control policy currently in effect for the given Cloud Run Service. This result does not include...
• cloud-run-admin-pp-cli services list — Lists Services.
• cloud-run-admin-pp-cli services patch — Updates a Service.
• cloud-run-admin-pp-cli services set-iam-policy — Sets the IAM Access control policy for the specified Service. Overwrites any existing policy.
• cloud-run-admin-pp-cli services test-iam-permissions — Returns permissions that a caller has on the specified Project. There are no permissions required for making this...

Finding the right command

When you know what you want to do but not which command does it, ask the CLI directly:

cloud-run-admin-pp-cli which "<capability in your own words>"

which resolves a natural-language capability query to the best matching command from this CLI's curated feature index. Exit code 0 means at least one match; exit code 2 means no confident match — fall back to --help or use a narrower query.

Recipes

Find the right Cloud Run command

cloud-run-admin-pp-cli which "show service revisions" --json

Use intent search before calling a specific Cloud Run Admin command.

List services with compact agent output

cloud-run-admin-pp-cli services list projects/PROJECT_ID/locations/REGION --agent --select services.name,services.uri,nextPageToken

Combines agent defaults with field selection so agents avoid parsing large service payloads.

Search synced inventory

cloud-run-admin-pp-cli search "api" --type services --json --select resource_type,title

Search local Cloud Run inventory after a sync.

Auth Setup

Cloud Run Admin uses Google OAuth bearer tokens with the cloud-platform scope. For local use, run gcloud auth print-access-token and export the value as CLOUD_RUN_ADMIN_OAUTH2C; do not commit the token or paste it into docs.

Run cloud-run-admin-pp-cli doctor to verify setup.