From 644c0aa2922daba56b2b2ebd51a5a5b695fa3a58 Mon Sep 17 00:00:00 2001 From: ParsaKhaz Date: Tue, 16 Jun 2026 23:49:51 -0700 Subject: [PATCH 1/2] docs: keep fallback installers visible --- README.md | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index 91d167a1..aee5006b 100644 --- a/README.md +++ b/README.md @@ -32,9 +32,7 @@

-
-Other install methods -
+**Package-manager alternatives** pnpm
pnpm dlx runpane@latest
@@ -46,12 +44,16 @@ 
npm i -g runpane
 runpane setup
+**Shell installers** + Mac / Linux shell installer
curl -fsSL https://runpane.com/install.sh | sh
Windows PowerShell installer
irm https://runpane.com/install.ps1 | iex
+**Direct downloads** + Download for macOS @@ -62,8 +64,6 @@ runpane setup Download for Linux -
-

@@ -204,7 +204,7 @@ npx --yes runpane@latest The wizard can install Pane on this machine, configure this machine as a remote host, update Pane, or run diagnostics. -### Advanced Install Methods +### Package Manager Commands Explicit desktop install: @@ -221,6 +221,8 @@ npm i -g runpane runpane setup ``` +### Shell Installers + Mac / Linux shell installer: ```bash From eb9df468bd95d5445fad1221ba47e1e115acfcf0 Mon Sep 17 00:00:00 2001 From: ParsaKhaz Date: Wed, 17 Jun 2026 10:55:01 -0700 Subject: [PATCH 2/2] docs: document runpane client maintenance --- packages/runpane-py/README.md | 16 ++++++++++++++++ packages/runpane/README.md | 16 ++++++++++++++++ 2 files changed, 32 insertions(+) diff --git a/packages/runpane-py/README.md b/packages/runpane-py/README.md index 94550b78..c1c2e695 100644 --- a/packages/runpane-py/README.md +++ b/packages/runpane-py/README.md @@ -95,6 +95,22 @@ PyPI package downloads use `source=pip` when requesting release artifacts from `runpane.com/api/download`. If that route is unavailable, the CLI falls back to matching GitHub release assets and prints a warning. +## Maintenance Notes + +Keep the npm and PyPI clients in sync with each Pane release. When changing +shared installer behavior: + +- If release asset names or platforms change, update both npm and PyPI wrapper + artifact matching. +- If `runpane` CLI behavior changes, update both clients and the shared smoke + tests. +- If the website `/api/download` contract changes, verify npm and PyPI fallback + behavior. +- If daemon setup flags change, update docs, README files, and wrapper tests + together. +- Keep the CI wrapper matrix green: Linux, macOS, Windows, Node 18/22, and + Python 3.8/3.13. + ## Publishing This package should be published through PyPI Trusted Publishing from GitHub diff --git a/packages/runpane/README.md b/packages/runpane/README.md index 6bba43d2..12991073 100644 --- a/packages/runpane/README.md +++ b/packages/runpane/README.md @@ -97,6 +97,22 @@ npm package downloads use `source=npm` when requesting release artifacts from `runpane.com/api/download`. If that route is unavailable, the CLI falls back to matching GitHub release assets and prints a warning. +## Maintenance Notes + +Keep the npm and PyPI clients in sync with each Pane release. When changing +shared installer behavior: + +- If release asset names or platforms change, update both npm and PyPI wrapper + artifact matching. +- If `runpane` CLI behavior changes, update both clients and the shared smoke + tests. +- If the website `/api/download` contract changes, verify npm and PyPI fallback + behavior. +- If daemon setup flags change, update docs, README files, and wrapper tests + together. +- Keep the CI wrapper matrix green: Linux, macOS, Windows, Node 18/22, and + Python 3.8/3.13. + ## Publishing This package should be published through npm Trusted Publishing from GitHub