From 3f09a92f674b415893c3b6276c5141cc29f1465b Mon Sep 17 00:00:00 2001 From: bubbapang Date: Fri, 4 Sep 2026 16:55:02 +0800 Subject: [PATCH 1/2] mining guide: a Windows path without WSL2, and a one-command skill install Two additions at the top of the guide, no existing instructions changed. The guide says it works on "macOS and Linux (including WSL2 on Windows)", and the setup script does need WSL2. A Windows user without it finishes the intro with nothing to run, even though the Miner App already covers that case and is the most-downloaded artifact of miner-v0.6.1 (21 Windows downloads, against 8 Linux and 3 macOS). Added a pointer to it. It links the GitHub release rather than docs/guides/miner-app.md because that page is draft: true and currently 404s. If the flag lifts, the link should move to the guide. The guide also tells agent users to press Copy Context and paste. For Claude Code the skill can just be installed, which is faster and persists across sessions. Verified against an isolated HOME: exit 0, 323 lines, frontmatter intact. Co-Authored-By: Claude Sonnet 5 --- docs/guides/mining.md | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/docs/guides/mining.md b/docs/guides/mining.md index 67f110e..e76acc1 100644 --- a/docs/guides/mining.md +++ b/docs/guides/mining.md @@ -5,10 +5,20 @@ title: Mining and Running a Node # Mining and Running a Node -This guide covers connecting to the Quantus Planck testnet and mining. Works on macOS and Linux (including WSL2 on Windows). +This guide covers connecting to the Quantus Planck testnet and mining. The setup script below runs on macOS and Linux, including WSL2 on Windows. + +**On Windows without WSL2?** Use the [Miner App](https://github.com/Quantus-Network/quantus-apps/releases/latest) (`quantus_miner_windows.zip`) instead. It is a desktop app that downloads the node for you and handles identity, mining, and rewards in one window, with no terminal. Use the **Copy Context** button at the top of this page to copy everything as Markdown -- the full guide plus an AI mining skill. Paste it to an agent like Claude Code to be walked through setup interactively, or keep it as an offline reference. +If you use Claude Code, install the skill from disk in one command instead of pasting: + +```bash +mkdir -p ~/.claude/skills/mining && curl -fsSL https://docs.quantus.com/skills/mining-skill.md -o ~/.claude/skills/mining/SKILL.md +``` + +Then run `/mining`. The skill walks the same steps as this guide, and it probes the binaries you actually downloaded before starting anything, so it will not hand you a mismatched node and miner pair. + ## Prerequisites Before starting, you will need: From 3fc073bf9821ef2de598db7592042dac3aadf84c Mon Sep 17 00:00:00 2001 From: bubbapang Date: Fri, 4 Sep 2026 17:10:01 +0800 Subject: [PATCH 2/2] mining guide: give the skill install a PowerShell variant that actually runs The one-command install was bash only. On Windows PowerShell 5.1, still the default shell on Windows, it fails twice: && is a parser error there, and curl is an alias for Invoke-WebRequest, which does not accept -fsSL. A Windows reader following the guide in the shell they already have open hits a parser error before anything downloads. Tested on this machine, writing to an explicit path each time: Git Bash bash line exit 0, 16508 bytes PowerShell 5.1 bash line parser error at &&, then curl alias PowerShell 5.1 PowerShell line exit 0, 16508 bytes PowerShell 7.6 PowerShell line exit 0 The PowerShell version invokes curl.exe explicitly and separates statements with a semicolon, so it runs on both 5.1 and 7. The note under the block records why, so nobody later collapses the two blocks back into one that only works in bash. Co-Authored-By: Claude Sonnet 5 --- docs/guides/mining.md | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/docs/guides/mining.md b/docs/guides/mining.md index e76acc1..4119c70 100644 --- a/docs/guides/mining.md +++ b/docs/guides/mining.md @@ -11,12 +11,22 @@ This guide covers connecting to the Quantus Planck testnet and mining. The setup Use the **Copy Context** button at the top of this page to copy everything as Markdown -- the full guide plus an AI mining skill. Paste it to an agent like Claude Code to be walked through setup interactively, or keep it as an offline reference. -If you use Claude Code, install the skill from disk in one command instead of pasting: +If you use Claude Code, install the skill from disk in one command instead of pasting. + +macOS, Linux, or Git Bash on Windows: ```bash mkdir -p ~/.claude/skills/mining && curl -fsSL https://docs.quantus.com/skills/mining-skill.md -o ~/.claude/skills/mining/SKILL.md ``` +Windows PowerShell: + +```powershell +New-Item -ItemType Directory -Force "$HOME\.claude\skills\mining" | Out-Null; curl.exe -fsSL https://docs.quantus.com/skills/mining-skill.md -o "$HOME\.claude\skills\mining\SKILL.md" +``` + +The PowerShell version is not a style preference. Windows PowerShell 5.1, still the default on Windows, treats `&&` as a parser error and aliases `curl` to `Invoke-WebRequest`, which does not accept `-fsSL`. Calling `curl.exe` explicitly and separating with `;` works on both 5.1 and PowerShell 7. + Then run `/mining`. The skill walks the same steps as this guide, and it probes the binaries you actually downloaded before starting anything, so it will not hand you a mismatched node and miner pair. ## Prerequisites