Skill

cloud-run-admin

Agent-native CLI for the Google Cloud Run Admin API (v1 Knative-Serving + v2 AIP-aligned). Wraps services, revisions, jobs, executions, tasks, and operations behind typed exit codes, --compact JSON output, and a local SQLite snapshot so agents can list / search / compound-query Cloud Run state without re-hitting the API.

Verified: 2026-05-13 (printing-press-ingest-2026-05-13+enrich-capability-skill)

When to use cloud-run-admin

Choose if

You're managing Google Cloud Run from an agent loop and want a typed, compact-output CLI that wraps the Admin API (v1 + v2), caches state locally for repeat queries, and surfaces operation status without manual gcloud polling. Prefer this over hand-writing curl calls to run.googleapis.com or shelling out to `gcloud run` and parsing its human-formatted output.

Avoid if

You need to manage GCP surfaces beyond Cloud Run (Cloud Functions, GKE, BigQuery, Pub/Sub) — this skill is Cloud-Run-scoped only. Also avoid if your agent already has the `gcloud` CLI available and the workflow is one-shot rather than agent-replayable.

Risk Flags

  • MEDIUM auth Requires Google OAuth bearer tokens with the cloud-platform scope. README warns "do not commit the token or paste it into docs" — agents must source the token from a secure vault, not from environment files committed to git.
  • MEDIUM runtime Long-running operations (deploys, job executions) honor the Cloud Run operation timeout, not the CLI's --timeout flag. Agents must poll the operation endpoint to confirm completion; best-effort semantics can return state before the requested timeout.
  • LOW scope Scope is the Cloud Run Admin API only — does not cover other GCP surfaces (Cloud Functions, GKE, Compute Engine). For a broader gcloud replacement, use a different skill.

Cost

Type: Usage based · Free tier: The CLI binary is MIT-licensed and free to install. Cloud Run itself has a generous GCP free tier (2M requests/month) but pricing is set by Google, not by this skill.

Hidden costs

  • The CLI is free; the upstream Google Cloud Run API bills against your GCP project (compute / memory / requests). No usage cap from this skill.

Install

Default

npx -y @mvanhorn/printing-press install cloud-run-admin
# Set Google OAuth bearer token with cloud-platform scope:
gcloud auth print-access-token > /tmp/gcp-token
export GOOGLE_OAUTH_TOKEN=$(cat /tmp/gcp-token)

Setup docs →

Estimated time to first success: ~10 min

Dependencies

Minimum runtime: Node.js (for npx install) or Go 1.25+ (source install)

Distribution

Repository
https://github.com/mvanhorn/printing-press-library
License
MIT