@redocly/cli 2.70.0 → 2.71.1

package/lib/skills/redocly-cli/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: redocly-cli
-description: Redocly CLI for OpenAPI, AsyncAPI, Arazzo, and Overlay descriptions, and for Markdown docs. Use when the user wants to lint, bundle, split, or join an API description, apply decorators or overlays, build or preview API docs, lint Markdown or prose with recheck, test a live API with respect or Arazzo, capture traffic or check drift, get stats or a score, generate a TypeScript client, document an MCP server in an OpenAPI description, push to the Redocly platform, or find the node type a rule or plugin should target.
+description: Redocly CLI for OpenAPI, AsyncAPI, Arazzo, and Overlay descriptions, and for Markdown docs. Use when the user wants to lint, bundle, split, or join an API description, apply decorators or overlays, build or preview API docs, lint Markdown or prose with recheck, test a live API with respect or Arazzo, capture traffic or check drift, get stats or a score, generate a TypeScript client, document an MCP server in an OpenAPI description, push to the Redocly platform, clone a Redocly-hosted project and open its pull requests, or find the node type a rule or plugin should target.
 ---
 
 # Redocly CLI usage
@@ -49,6 +49,9 @@ Install: `npm i @redocly/cli@latest`, or run without installing: `npx @redocly/c
 | `inspect-node-types` | Show the node type at a pointer, or list every node with its type [experimental]                                  | Redocly configuration |
 | `push`               | Push an API description to the Redocly platform                                                                   | Platform              |
 | `push-status`        | Track an in-progress push to the platform                                                                         | Platform              |
+| `project clone`      | Clone a Redocly-hosted project as a Git repository [early access]                                                 | Platform              |
+| `project pr create`  | Open a pull request for the current branch of a cloned project [early access]                                     | Platform              |
+| `project pr status`  | Show the state, review, checks, and preview URL of that pull request [early access]                               | Platform              |
 | `skills`             | Install the Redocly CLI agent skills into `.agents/skills/` and detected agent folders                            | Agent setup           |
 | `completion`         | Generate shell autocomplete commands                                                                              | Shell setup           |
 
@@ -181,6 +184,22 @@ With `apis.<name>.clientOutput` set, a bare `redocly generate-client` generates
 An API's own `client` block replaces the top-level one wholesale — repeat the shared fields in it.
 With `client.codeSamples: true`, it also writes `<output>.code-samples.yaml`, an overlay that adds `x-codeSamples`; add it to the API's `overlays` (or pass `--overlay`) so `bundle` puts the samples in the description.
 
+## Work on a Redocly-hosted project
+
+After `redocly login`, `project clone <organization>/<project>` clones a project that the Redocly platform hosts.
+The clone uses Redocly CLI as its Git credential helper, so `git pull` and `git push` work without a token.
+The platform rejects pushes to the default branch: push another branch, then open a pull request for it:
+
+```bash
+git push -u origin fix-typo
+redocly project pr create --title "Fix a typo" --body-file - <<'BODY'
+Fixes the install command in the quickstart.
+BODY
+```
+
+The command prints the pull request URL.
+The platform builds a preview in a few minutes; `redocly project pr status` then shows the state, the review decision, the checks, and the preview URL after the preview is deployed.
+
 ## Test a live API
 
 `respect` executes an [Arazzo](https://spec.openapis.org/arazzo/latest.html) description as a test suite against a running API, asserting real responses match the description.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@redocly/cli",
-  "version": "2.70.0",
+  "version": "2.71.1",
   "description": "",
   "license": "MIT",
   "type": "module",