Update to Render
Snapshot Oct 24, 2026 · 12:46 UTC · version 1.0.2
Collection source: downloaded plugin package. These snapshots do not have a confirmed matching collection source. Differences in file lists alone do not establish changes to the package.
Instructions updated for render-cli
Skill instructions — Now says: Before installing, authenticating, selecting a workspace, or running commands, read `references/render-access.md` for the current access and...
Observed in instructions or declared skills. Runtime behavior has not been tested.
Up to 10 plugins free · no card required.
All fields and original values.
Skill instructions
Sep 30, 2026 · 22:43 UTC
## Installation | Method | Command | |--------|---------| | **Homebrew** | `brew update && brew install render` | | **Linux/macOS** | `curl -fsSL https://raw.githubusercontent.com/render-oss/cli/refs/heads/main/bin/install.sh \| sh` | | ...
Oct 24, 2026 · 12:46 UTC
Before installing, authenticating, selecting a workspace, or running commands, read `references/render-access.md` for the current access and command-discovery workflow. Use the installed CLI help or generated command reference as directe...
Supporting files
Sep 30, 2026 · 22:43 UTC
[{"relative_path":"references/command-cheatsheet.md","size_in_bytes":2965}]
Oct 24, 2026 · 12:46 UTC
[{"relative_path":"references/command-cheatsheet.md","size_in_bytes":2547},{"relative_path":"references/render-access.md","size_in_bytes":4830}]
Compare saved observations
Download comparison JSONSKILL.md text changes
− removed · + added
--- before +++ after @@ -20,6 +20,8 @@ The Render CLI manages services, databases, and deployments from the terminal. Supports interactive use, non-interactive scripting, and CI/CD automation. +Before installing, authenticating, selecting a workspace, or running commands, read `references/render-access.md` for the current access and command-discovery workflow. + ## When to Use - **Deploying** a service from the terminal or CI/CD @@ -30,74 +32,9 @@ - **Scripting** Render operations in CI/CD pipelines - **Installing** agent skills for AI coding tools -## Installation - -| Method | Command | -|--------|---------| -| **Homebrew** | `brew update && brew install render` | -| **Linux/macOS** | `curl -fsSL https://raw.githubusercontent.com/render-oss/cli/refs/heads/main/bin/install.sh \| sh` | -| **Direct download** | [GitHub releases](https://github.com/render-oss/cli/releases/) | -| **Build from source** | `git clone git@github.com:render-oss/cli.git && cd cli && go build -o render` | - -After install, run `render` with no arguments to confirm. - -## Authentication - -### Interactive (local dev) - -```bash -render login -``` - -Opens the browser to generate a CLI token. Token is saved to `~/.render/cli.yaml`. Tokens expire periodically—re-run `render login` when prompted. - -### Non-interactive (CI/CD) - -```bash -export RENDER_API_KEY=rnd_... -``` - -API keys do not expire. Generate one from **Account Settings > API Keys** in the Dashboard. The API key takes precedence over CLI tokens when set. - -Set the active workspace: - -```bash -render workspace set -``` - ## Command Reference -### Core commands - -| Command | Purpose | Key flags | -|---------|---------|-----------| -| `render login` | Authenticate via browser | — | -| `render workspace set` | Set active workspace | — | -| `render services` | List all services and datastores | `-o json` for scripting | -| `render deploys create [SVC]` | Trigger a deploy | `--wait`, `--commit SHA`, `--image URL` | -| `render deploys list [SVC]` | List deploys for a service | `-o json` | -| `render logs -r [SVC]` | View logs | `--tail` for streaming | -| `render psql [DB]` | Open psql session | `-c "SQL"`, `-o json`, `-- --csv` | -| `render ssh [SVC]` | SSH into running instance | `--ephemeral` / `-e` for isolated shell | -| `render blueprints validate` | Validate `render.yaml` | Defaults to `./render.yaml` | -| `render skills [install\|update\|list]` | Manage agent skills | — | -| `render workspaces` | List workspaces | `-o json` | - -### Non-interactive mode - -For CI/CD and scripts, always set: - -| Flag | Purpose | -|------|---------| -| `-o json` (or `yaml`, `text`) | Machine-readable output | -| `--confirm` | Skip confirmation prompts | - -Output format precedence: `--output` flag > `RENDER_OUTPUT` env var > auto-detect (TTY → interactive, pipe → text). - -```bash -export RENDER_OUTPUT=json -render services --confirm -``` +Use the installed CLI help or generated command reference as directed by `references/render-access.md` for the exact command surface and flags. The patterns below cover common operational workflows. ### Deploy patterns @@ -135,38 +72,37 @@ steps: - name: Install Render CLI run: | - curl -L https://github.com/render-oss/cli/releases/download/v1.1.0/cli_1.1.0_linux_amd64.zip -o render.zip - unzip render.zip - sudo mv cli_v1.1.0 /usr/local/bin/render + curl --fail-with-body --silent --show-error --location \ + https://raw.githubusercontent.com/render-oss/cli/refs/heads/main/bin/install.sh \ + --output /tmp/install-render-cli.sh + sudo sh /tmp/install-render-cli.sh + render --version - name: Deploy env: RENDER_API_KEY: ${{ secrets.RENDER_API_KEY }} run: render deploys create ${{ secrets.RENDER_SERVICE_ID }} --wait --confirm -o json ``` -Pin to a specific CLI version in CI to avoid breaking changes. +If reproducible builds require a pinned CLI, select a currently supported release and verify its asset name in the current release documentation instead of copying a version from this skill. ## Local Config Config file: `~/.render/cli.yaml` -Override with `RENDER_CLI_CONFIG_PATH` env var. +Override the configuration directory with `RENDER_CLI_CONFIG_DIR`. `RENDER_CLI_CONFIG_PATH` is a legacy file-level override retained for compatibility and is scheduled for deprecation. ## Common Mistakes | Mistake | Fix | |---------|-----| -| Token expired | Re-run `render login` | -| Wrong workspace | Run `render workspace set` to switch | -| Missing `--confirm` in CI | Add `--confirm` to skip interactive prompts | -| Using `--output interactive` in CI | Use `-o json` or `-o text` in non-TTY environments | | Deploying without `--wait` in CI | Add `--wait` so the job fails on deploy failure | ## References | Document | Contents | |----------|----------| -| `references/command-cheatsheet.md` | Full command list with flags, output examples, and scripting patterns | +| `references/render-access.md` | Current CLI authentication, workspace, documentation, output, and authorization workflow | +| `references/command-cheatsheet.md` | Common operational command examples and scripting patterns | ## Related Skills @@ -174,3 +110,16 @@ - **render-blueprints** — `render.yaml` authoring and validation - **render-postgres** — Database connections, `render psql` usage - **render-debug** — Using `render logs` and `render ssh` for troubleshooting + +<!-- shared:documentation-retrieval --> +## Current documentation retrieval + +Whenever this skill directs you to consult current Render documentation: + +1. Retrieve the linked Markdown document directly with an available URL-fetching tool or HTTP client, such as `curl`. Do not substitute web-search summaries for the document. +2. Confirm that retrieval succeeded and returned the expected document, then read its contents. Saving a file or printing its path is not sufficient. +3. If the request fails or your tool cannot read the Markdown response, open and read the linked HTML version instead. +4. If neither version can be retrieved, disclose that the current reference is unavailable and follow any topic-specific fallback in the skill. Use bundled guidance only for stable constraints, and do not guess at changeable platform details. + +When a task requires multiple references, apply this workflow to each one and distinguish the documents you verified from those that remain unavailable. +<!-- /shared:documentation-retrieval -->
Full technical diff · 2 changed fields
changed /included_files
[
{
"relative_path": "references/command-cheatsheet.md",
"size_in_bytes": 2965
}
][
{
"relative_path": "references/command-cheatsheet.md",
"size_in_bytes": 2547
},
{
"relative_path": "references/render-access.md",
"size_in_bytes": 4830
}
]changed /skill_md_contents
"---\nname: render-cli\ndescription: >-\n Installs and uses the Render CLI for deploys, logs, SSH, psql, Blueprint\n validation, and automation. Use when the user needs to run Render CLI\n commands, script deploys in CI/CD, authenticate with an API key, query\n services non-interactively, or troubleshoot CLI auth issues.\n Trigger terms: render CLI, render login, render deploys, render logs,\n render ssh, render psql, render blueprints validate, render skills,\n RENDER_API_KEY, non-interactive, CI/CD deploy.\nlicense: MIT\ncompatibility: Render CLI v2.7.0+ (Homebrew, Linux/macOS, direct download)\nmetadata:\n author: Render\n version: \"1.0.0\"\n category: operations\n---\n\n# Render CLI\n\nThe Render CLI manages services, databases, and deployments from the terminal. Supports interactive use, non-interactive scripting, and CI/CD automation.\n\n## When to Use\n\n- **Deploying** a service from the terminal or CI/CD\n- **Tailing logs** in real time\n- **Opening psql** to a Render Postgres database\n- **SSHing** into a running service or launching an ephemeral shell\n- **Validating** a `render.yaml` Blueprint\n- **Scripting** Render operations in CI/CD pipelines\n- **Installing** agent skills for AI coding tools\n\n## Installation\n\n| Method | Command |\n|--------|---------|\n| **Homebrew** | `brew update && brew install render` |\n| **Linux/macOS** | `curl -fsSL https://raw.githubusercontent.com/render-oss/cli/refs/heads/main/bin/install.sh \\| sh` |\n| **Direct download** | [GitHub releases](https://github.com/render-oss/cli/releases/) |\n| **Build from source** | `git clone git@github.com:render-oss/cli.git && cd cli && go build -o render` |\n\nAfter install, run `render` with no arguments to confirm.\n\n## Authentication\n\n### Interactive (local dev)\n\n```bash\nrender login\n```\n\nOpens the browser to generate a CLI token. Token is saved to `~/.render/cli.yaml`. Tokens expire periodically—re-run `render login` when prompted.\n\n### Non-interactive (CI/CD)\n\n```bash\nexport RENDER_API_KEY=rnd_...\n```\n\nAPI keys do not expire. Generate one from **Account Settings > API Keys** in the Dashboard. The API key takes precedence over CLI tokens when set.\n\nSet the active workspace:\n\n```bash\nrender workspace set\n```\n\n## Command Reference\n\n### Core commands\n\n| Command | Purpose | Key flags |\n|---------|---------|-----------|\n| `render login` | Authenticate via browser | — |\n| `render workspace set` | Set active workspace | — |\n| `render services` | List all services and datastores | `-o json` for scripting |\n| `render deploys create [SVC]` | Trigger a deploy | `--wait`, `--commit SHA`, `--image URL` |\n| `render deploys list [SVC]` | List deploys for a service | `-o json` |\n| `render logs -r [SVC]` | View logs | `--tail` for streaming |\n| `render psql [DB]` | Open psql session | `-c \"SQL\"`, `-o json`, `-- --csv` |\n| `render ssh [SVC]` | SSH into running instance | `--ephemeral` / `-e` for isolated shell |\n| `render blueprints validate` | Validate `render.yaml` | Defaults to `./render.yaml` |\n| `render skills [install\\|update\\|list]` | Manage agent skills | — |\n| `render workspaces` | List workspaces | `-o json` |\n\n### Non-interactive mode\n\nFor CI/CD and scripts, always set:\n\n| Flag | Purpose |\n|------|---------|\n| `-o json` (or `yaml`, `text`) | Machine-readable output |\n| `--confirm` | Skip confirmation prompts |\n\nOutput format precedence: `--output` flag > `RENDER_OUTPUT` env var > auto-detect (TTY → interactive, pipe → text).\n\n```bash\nexport RENDER_OUTPUT=json\nrender services --confirm\n```\n\n### Deploy patterns\n\n```bash\n# Deploy and wait for completion (exits non-zero on failure)\nrender deploys create srv-xxx --wait --confirm -o json\n\n# Deploy a specific commit\nrender deploys create srv-xxx --commit abc123 --wait --confirm\n\n# Deploy a specific Docker image\nrender deploys create srv-xxx --image ghcr.io/org/app:v1.2.3 --wait --confirm\n```\n\n### Database queries\n\n```bash\n# Single query, JSON output\nrender psql db-xxx -c \"SELECT NOW();\" -o json\n\n# CSV output via psql passthrough\nrender psql db-xxx -c \"SELECT id, email FROM users;\" -o text -- --csv\n```\n\n## CI/CD Example (GitHub Actions)\n\n```yaml\nname: Deploy to Render\non:\n push:\n branches: [main]\njobs:\n deploy:\n runs-on: ubuntu-latest\n steps:\n - name: Install Render CLI\n run: |\n curl -L https://github.com/render-oss/cli/releases/download/v1.1.0/cli_1.1.0_linux_amd64.zip -o render.zip\n unzip render.zip\n sudo mv cli_v1.1.0 /usr/local/bin/render\n - name: Deploy\n env:\n RENDER_API_KEY: ${{ secrets.RENDER_API_KEY }}\n run: render deploys create ${{ secrets.RENDER_SERVICE_ID }} --wait --confirm -o json\n```\n\nPin to a specific CLI version in CI to avoid breaking changes.\n\n## Local Config\n\nConfig file: `~/.render/cli.yaml`\n\nOverride with `RENDER_CLI_CONFIG_PATH` env var.\n\n## Common Mistakes\n\n| Mistake | Fix |\n|---------|-----|\n| Token expired | Re-run `render login` |\n| Wrong workspace | Run `render workspace set` to switch |\n| Missing `--confirm` in CI | Add `--confirm` to skip interactive prompts |\n| Using `--output interactive` in CI | Use `-o json` or `-o text` in non-TTY environments |\n| Deploying without `--wait` in CI | Add `--wait` so the job fails on deploy failure |\n\n## References\n\n| Document | Contents |\n|----------|----------|\n| `references/command-cheatsheet.md` | Full command list with flags, output examples, and scripting patterns |\n\n## Related Skills\n\n- **render-deploy** — End-to-end deploy flows, MCP operations, Dashboard deeplinks\n- **render-blueprints** — `render.yaml` authoring and validation\n- **render-postgres** — Database connections, `render psql` usage\n- **render-debug** — Using `render logs` and `render ssh` for troubleshooting\n""---\nname: render-cli\ndescription: >-\n Installs and uses the Render CLI for deploys, logs, SSH, psql, Blueprint\n validation, and automation. Use when the user needs to run Render CLI\n commands, script deploys in CI/CD, authenticate with an API key, query\n services non-interactively, or troubleshoot CLI auth issues.\n Trigger terms: render CLI, render login, render deploys, render logs,\n render ssh, render psql, render blueprints validate, render skills,\n RENDER_API_KEY, non-interactive, CI/CD deploy.\nlicense: MIT\ncompatibility: Render CLI v2.7.0+ (Homebrew, Linux/macOS, direct download)\nmetadata:\n author: Render\n version: \"1.0.0\"\n category: operations\n---\n\n# Render CLI\n\nThe Render CLI manages services, databases, and deployments from the terminal. Supports interactive use, non-interactive scripting, and CI/CD automation.\n\nBefore installing, authenticating, selecting a workspace, or running commands, read `references/render-access.md` for the current access and command-discovery workflow.\n\n## When to Use\n\n- **Deploying** a service from the terminal or CI/CD\n- **Tailing logs** in real time\n- **Opening psql** to a Render Postgres database\n- **SSHing** into a running service or launching an ephemeral shell\n- **Validating** a `render.yaml` Blueprint\n- **Scripting** Render operations in CI/CD pipelines\n- **Installing** agent skills for AI coding tools\n\n## Command Reference\n\nUse the installed CLI help or generated command reference as directed by `references/render-access.md` for the exact command surface and flags. The patterns below cover common operational workflows.\n\n### Deploy patterns\n\n```bash\n# Deploy and wait for completion (exits non-zero on failure)\nrender deploys create srv-xxx --wait --confirm -o json\n\n# Deploy a specific commit\nrender deploys create srv-xxx --commit abc123 --wait --confirm\n\n# Deploy a specific Docker image\nrender deploys create srv-xxx --image ghcr.io/org/app:v1.2.3 --wait --confirm\n```\n\n### Database queries\n\n```bash\n# Single query, JSON output\nrender psql db-xxx -c \"SELECT NOW();\" -o json\n\n# CSV output via psql passthrough\nrender psql db-xxx -c \"SELECT id, email FROM users;\" -o text -- --csv\n```\n\n## CI/CD Example (GitHub Actions)\n\n```yaml\nname: Deploy to Render\non:\n push:\n branches: [main]\njobs:\n deploy:\n runs-on: ubuntu-latest\n steps:\n - name: Install Render CLI\n run: |\n curl --fail-with-body --silent --show-error --location \\\n https://raw.githubusercontent.com/render-oss/cli/refs/heads/main/bin/install.sh \\\n --output /tmp/install-render-cli.sh\n sudo sh /tmp/install-render-cli.sh\n render --version\n - name: Deploy\n env:\n RENDER_API_KEY: ${{ secrets.RENDER_API_KEY }}\n run: render deploys create ${{ secrets.RENDER_SERVICE_ID }} --wait --confirm -o json\n```\n\nIf reproducible builds require a pinned CLI, select a currently supported release and verify its asset name in the current release documentation instead of copying a version from this skill.\n\n## Local Config\n\nConfig file: `~/.render/cli.yaml`\n\nOverride the configuration directory with `RENDER_CLI_CONFIG_DIR`. `RENDER_CLI_CONFIG_PATH` is a legacy file-level override retained for compatibility and is scheduled for deprecation.\n\n## Common Mistakes\n\n| Mistake | Fix |\n|---------|-----|\n| Deploying without `--wait` in CI | Add `--wait` so the job fails on deploy failure |\n\n## References\n\n| Document | Contents |\n|----------|----------|\n| `references/render-access.md` | Current CLI authentication, workspace, documentation, output, and authorization workflow |\n| `references/command-cheatsheet.md` | Common operational command examples and scripting patterns |\n\n## Related Skills\n\n- **render-deploy** — End-to-end deploy flows, MCP operations, Dashboard deeplinks\n- **render-blueprints** — `render.yaml` authoring and validation\n- **render-postgres** — Database connections, `render psql` usage\n- **render-debug** — Using `render logs` and `render ssh` for troubleshooting\n\n<!-- shared:documentation-retrieval -->\n## Current documentation retrieval\n\nWhenever this skill directs you to consult current Render documentation:\n\n1. Retrieve the linked Markdown document directly with an available URL-fetching tool or HTTP client, such as `curl`. Do not substitute web-search summaries for the document.\n2. Confirm that retrieval succeeded and returned the expected document, then read its contents. Saving a file or printing its path is not sufficient.\n3. If the request fails or your tool cannot read the Markdown response, open and read the linked HTML version instead.\n4. If neither version can be retrieved, disclose that the current reference is unavailable and follow any topic-specific fallback in the skill. Use bundled guidance only for stable constraints, and do not guess at changeable platform details.\n\nWhen a task requires multiple references, apply this workflow to each one and distinguish the documents you verified from those that remain unavailable.\n<!-- /shared:documentation-retrieval -->\n"Full snapshot data
{
"description": "Installs and uses the Render CLI for deploys, logs, SSH, psql, Blueprint validation, and automation. Use when the user needs to run Render CLI commands, script deploys in CI/CD, authenticate with an API key, query services non-interactively, or troubleshoot CLI auth issues. Trigger terms: render CLI, render login, render deploys, render logs, render ssh, render psql, render blueprints validate, render skills, RENDER_API_KEY, non-interactive, CI/CD deploy.",
"included_files": [
{
"relative_path": "references/command-cheatsheet.md",
"size_in_bytes": 2547
},
{
"relative_path": "references/render-access.md",
"size_in_bytes": 4830
}
],
"name": "render-cli",
"skill_md_contents": "---\nname: render-cli\ndescription: >-\n Installs and uses the Render CLI for deploys, logs, SSH, psql, Blueprint\n validation, and automation. Use when the user needs to run Render CLI\n commands, script deploys in CI/CD, authenticate with an API key, query\n services non-interactively, or troubleshoot CLI auth issues.\n Trigger terms: render CLI, render login, render deploys, render logs,\n render ssh, render psql, render blueprints validate, render skills,\n RENDER_API_KEY, non-interactive, CI/CD deploy.\nlicense: MIT\ncompatibility: Render CLI v2.7.0+ (Homebrew, Linux/macOS, direct download)\nmetadata:\n author: Render\n version: \"1.0.0\"\n category: operations\n---\n\n# Render CLI\n\nThe Render CLI manages services, databases, and deployments from the terminal. Supports interactive use, non-interactive scripting, and CI/CD automation.\n\nBefore installing, authenticating, selecting a workspace, or running commands, read `references/render-access.md` for the current access and command-discovery workflow.\n\n## When to Use\n\n- **Deploying** a service from the terminal or CI/CD\n- **Tailing logs** in real time\n- **Opening psql** to a Render Postgres database\n- **SSHing** into a running service or launching an ephemeral shell\n- **Validating** a `render.yaml` Blueprint\n- **Scripting** Render operations in CI/CD pipelines\n- **Installing** agent skills for AI coding tools\n\n## Command Reference\n\nUse the installed CLI help or generated command reference as directed by `references/render-access.md` for the exact command surface and flags. The patterns below cover common operational workflows.\n\n### Deploy patterns\n\n```bash\n# Deploy and wait for completion (exits non-zero on failure)\nrender deploys create srv-xxx --wait --confirm -o json\n\n# Deploy a specific commit\nrender deploys create srv-xxx --commit abc123 --wait --confirm\n\n# Deploy a specific Docker image\nrender deploys create srv-xxx --image ghcr.io/org/app:v1.2.3 --wait --confirm\n```\n\n### Database queries\n\n```bash\n# Single query, JSON output\nrender psql db-xxx -c \"SELECT NOW();\" -o json\n\n# CSV output via psql passthrough\nrender psql db-xxx -c \"SELECT id, email FROM users;\" -o text -- --csv\n```\n\n## CI/CD Example (GitHub Actions)\n\n```yaml\nname: Deploy to Render\non:\n push:\n branches: [main]\njobs:\n deploy:\n runs-on: ubuntu-latest\n steps:\n - name: Install Render CLI\n run: |\n curl --fail-with-body --silent --show-error --location \\\n https://raw.githubusercontent.com/render-oss/cli/refs/heads/main/bin/install.sh \\\n --output /tmp/install-render-cli.sh\n sudo sh /tmp/install-render-cli.sh\n render --version\n - name: Deploy\n env:\n RENDER_API_KEY: ${{ secrets.RENDER_API_KEY }}\n run: render deploys create ${{ secrets.RENDER_SERVICE_ID }} --wait --confirm -o json\n```\n\nIf reproducible builds require a pinned CLI, select a currently supported release and verify its asset name in the current release documentation instead of copying a version from this skill.\n\n## Local Config\n\nConfig file: `~/.render/cli.yaml`\n\nOverride the configuration directory with `RENDER_CLI_CONFIG_DIR`. `RENDER_CLI_CONFIG_PATH` is a legacy file-level override retained for compatibility and is scheduled for deprecation.\n\n## Common Mistakes\n\n| Mistake | Fix |\n|---------|-----|\n| Deploying without `--wait` in CI | Add `--wait` so the job fails on deploy failure |\n\n## References\n\n| Document | Contents |\n|----------|----------|\n| `references/render-access.md` | Current CLI authentication, workspace, documentation, output, and authorization workflow |\n| `references/command-cheatsheet.md` | Common operational command examples and scripting patterns |\n\n## Related Skills\n\n- **render-deploy** — End-to-end deploy flows, MCP operations, Dashboard deeplinks\n- **render-blueprints** — `render.yaml` authoring and validation\n- **render-postgres** — Database connections, `render psql` usage\n- **render-debug** — Using `render logs` and `render ssh` for troubleshooting\n\n<!-- shared:documentation-retrieval -->\n## Current documentation retrieval\n\nWhenever this skill directs you to consult current Render documentation:\n\n1. Retrieve the linked Markdown document directly with an available URL-fetching tool or HTTP client, such as `curl`. Do not substitute web-search summaries for the document.\n2. Confirm that retrieval succeeded and returned the expected document, then read its contents. Saving a file or printing its path is not sufficient.\n3. If the request fails or your tool cannot read the Markdown response, open and read the linked HTML version instead.\n4. If neither version can be retrieved, disclose that the current reference is unavailable and follow any topic-specific fallback in the skill. Use bundled guidance only for stable constraints, and do not guess at changeable platform details.\n\nWhen a task requires multiple references, apply this workflow to each one and distinguish the documents you verified from those that remain unavailable.\n<!-- /shared:documentation-retrieval -->\n"
}SHA-256 of public snapshot: 8c12b7a0c7ab9e5c9169205a838f5c11f4a89f96af1f24ac1be5ad1c806c8b1a