temporal-cloud-setup

Provisions Temporal Cloud namespaces and runs a sample Workflow end to end.

5.3k|765|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/openai/plugins --skill temporal-cloud-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: temporal-cloud-setup
Source: https://github.com/openai/plugins/tree/main/plugins/temporal/skills/temporal-cloud-setup
Command: npx skills add https://github.com/openai/plugins --skill temporal-cloud-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Setting up Temporal Cloud for the first time involves many error-prone steps: installing the prerelease CLI, authenticating, creating a billable namespace, minting an API key, writing the client config TOML, and connecting a Worker. This Skill performs the entire setup for you as a guided wizard, so you end with a running sample Workflow instead of a pile of half-finished CLI commands.

Core Features & Use Cases

  • End-to-end Cloud provisioning: Installs the unified Temporal CLI, signs in via browser, creates a namespace and API key, and writes the cloud-setup profile to temporal.toml — with the secret token never exposed in chat or diffs.
  • Multi-SDK sample scaffolding: Clones the pre-wired money-transfer sample and installs dependencies for Python, TypeScript, Go, Java, .NET, and Ruby, with package-manager detection and version checks.
  • Guided Workflow execution: Starts the Worker, runs the starter to completion, and optionally injects a transient failure to demonstrate Temporal's failure recovery.
  • Use Case: A developer new to Temporal asks to get started on Temporal Cloud; the Skill walks them through SDK selection, region choice, and provisioning, then shows their first Workflow completing in the Cloud UI.

Quick Start

Ask the assistant to set up Temporal Cloud and run a sample Workflow, then pick your SDK and region when prompted.

Frequently Asked Questions about temporal-cloud-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up Temporal Cloud and run my first Workflow?

Invoke this Skill and it performs the full setup: installs the prerelease Temporal CLI, signs you in via browser, creates a namespace and API key, writes the temporal.toml profile, clones a sample app, and runs a Workflow to completion. You only pick the SDK, region, and clone directory.

Which SDKs does the Temporal Cloud sample support?

The Skill supports Python, TypeScript, Go, Java, .NET, and Ruby. Each SDK clones its money-transfer-project sample on the pre-wired cloud-setup branch, which loads connection settings from the cloud-setup profile in temporal.toml.

Why does Temporal Cloud setup fail with cloud-unreachable after login succeeds?

Login and whoami work offline using a cached token, so they prove only that a credential exists, not that the Cloud API is reachable. The region list is the real connectivity check; if it fails, fix outbound network or sandbox egress to *.tmprl.cloud rather than re-authenticating.

Does the Temporal Cloud API key ever appear in chat or files?

No. The provision.sh script captures the one-time token and writes it directly into the locked temporal.toml file with 0600 permissions. Only the non-secret KeyId is ever printed, and the Skill forbids reading or displaying the config file.

Can I run this Skill in a sandboxed environment without network access?

No. The Skill shells out to the real Temporal CLI and reaches the Cloud API over gRPC, so it requires outbound internet access. Sandboxes that block egress, such as the default Codex sandbox, will fail at the region connectivity check.

What happens if my Temporal API key expires or hits the key limit?

An expired key triggers a key-expired fast-fail; re-run create-key to mint a fresh one, which overwrites the cloud-setup profile. If the account hits its API-key cap, delete stale keys with temporal cloud apikey delete, then re-run create-key.