From a3eb6bc95920b211b3f0a5beaa4dab1ee7adb6d9 Mon Sep 17 00:00:00 2001 From: Vikhyath Mondreti Date: Tue, 23 Jun 2026 23:57:32 -0700 Subject: [PATCH] improvement(pi): minor improvements to docs --- apps/docs/content/docs/en/workflows/blocks/meta.json | 4 ++-- apps/docs/content/docs/en/workflows/blocks/pi.mdx | 6 +++--- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/apps/docs/content/docs/en/workflows/blocks/meta.json b/apps/docs/content/docs/en/workflows/blocks/meta.json index 567a0c3417f..8b5cd58012a 100644 --- a/apps/docs/content/docs/en/workflows/blocks/meta.json +++ b/apps/docs/content/docs/en/workflows/blocks/meta.json @@ -2,7 +2,6 @@ "title": "Core Blocks", "pages": [ "agent", - "pi", "api", "function", "condition", @@ -17,6 +16,7 @@ "human-in-the-loop", "variables", "wait", - "credential" + "credential", + "pi" ] } diff --git a/apps/docs/content/docs/en/workflows/blocks/pi.mdx b/apps/docs/content/docs/en/workflows/blocks/pi.mdx index f98095bdb1a..2bee2901742 100644 --- a/apps/docs/content/docs/en/workflows/blocks/pi.mdx +++ b/apps/docs/content/docs/en/workflows/blocks/pi.mdx @@ -25,7 +25,7 @@ Pick the mode with the **Mode** dropdown. The fields below it change to match. Cloud runs entirely inside a disposable sandbox, so it never touches your machine. It clones the repo, lets the agent work with full read/shell/edit/git, pushes a branch, and opens a PR you review and merge. - Requires sandbox execution to be enabled (the Cloud option only appears when it is). -- Requires **your own provider API key (BYOK)** — the model key is handed to the sandbox, so Sim never injects a hosted key there. +- Requires **your own provider API key (BYOK)** — the model key is handed to the sandbox. - Needs a **GitHub token** with permission to clone, push, and open a PR (see [Setup](#setup-cloud)). - The deliverable is a **pull request** — nothing is committed to your default branch directly. @@ -118,7 +118,7 @@ The one case neither layer can rescue is a *first* prompt that already exceeds t ## Setup -### Cloud +### Cloud [#setup-cloud] Cloud runs in a sandbox image with the Pi CLI and git baked in. @@ -128,7 +128,7 @@ Cloud runs in a sandbox image with the Pi CLI and git baked in. - *Fine-grained:* select the repo, then **Contents: Read and write** + **Pull requests: Read and write**. - *Classic:* the **`repo`** scope. For org repos, authorize the token for SSO. -### Local +### Local [#setup-local] 1. **Enable SSH** on the target machine (on macOS: System Settings → General → Sharing → Remote Login). 2. **Expose it on a public host.** Sim blocks `localhost`/LAN, so use a TCP tunnel — for example `ngrok tcp 22`, which gives a `host:port` to put in **Host** and **Port**.