From 3e77291593844358732c69fb08c003d4276ff3d8 Mon Sep 17 00:00:00 2001 From: Jay Berg Date: Fri, 30 Oct 2026 13:43:05 -0700 Subject: [PATCH 1/9] docs: three-step native Windows install --- README.md | 14 ++++++-------- 1 file changed, 6 insertions(+), 8 deletions(-) diff --git a/README.md b/README.md index f865ac2..24f9bd3 100644 --- a/README.md +++ b/README.md @@ -84,17 +84,15 @@ and follow the steps top to bottom. **Windows — native, no WSL2** -1. Start menu → `PowerShell`. In it: - ```powershell - winget install Python.Python.3.12 - ``` - (Or python.org's installer with *Add python.exe to PATH* ticked.) -2. Open a **new** terminal — the old one does not see Python yet. +1. Install Python 3.12 from the Microsoft Store, or from + with *Add python.exe to PATH* ticked. +2. Start menu → `PowerShell`. 3. ```powershell - python -m pip install sidepit + pip install sidepit sidepit ``` - Windows Terminal renders the cockpit best. Keys live in `%USERPROFILE%\.sidepit\keys`. + If `sidepit` is not found, run `python -m sidepit_tui` instead. Windows + Terminal renders the cockpit best. Keys live in `%USERPROFILE%\.sidepit\keys`. **macOS (Apple Silicon or Intel)** From d9e365e853116cc812443cccf35032835f90621b Mon Sep 17 00:00:00 2001 From: Jay Berg Date: Fri, 30 Oct 2026 13:45:31 -0700 Subject: [PATCH 2/9] docs: Windows needs Python 3.13, not 3.15 --- README.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 24f9bd3..cf03eaa 100644 --- a/README.md +++ b/README.md @@ -84,8 +84,10 @@ and follow the steps top to bottom. **Windows — native, no WSL2** -1. Install Python 3.12 from the Microsoft Store, or from +1. Install **Python 3.13** from the Microsoft Store, or from with *Add python.exe to PATH* ticked. + Not 3.15: one dependency has no Windows wheel for it yet, so pip tries to + compile and fails on a stock machine. 2. Start menu → `PowerShell`. 3. ```powershell pip install sidepit From 84f1013a765c079f59a4817e8cdcbaf7722c693d Mon Sep 17 00:00:00 2001 From: Jay Berg Date: Fri, 30 Oct 2026 13:46:13 -0700 Subject: [PATCH 3/9] =?UTF-8?q?docs:=20Python=203.10=E2=80=933.14,=20insta?= =?UTF-8?q?ll=203.13=20on=20Windows=20and=20macOS?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/README.md b/README.md index cf03eaa..c3d8b87 100644 --- a/README.md +++ b/README.md @@ -57,9 +57,11 @@ sending straight to the lock address does not identify the intended account. ## Claude + Sidepit: two terminals -**Step 1 — install the cockpit.** Python 3.10 or newer. Nothing compiles: every piece arrives as a prebuilt -wheel on Linux, macOS (Apple Silicon and Intel) and Windows. Pick your machine -and follow the steps top to bottom. +**Step 1 — install the cockpit.** Python 3.10 to 3.14 — **not 3.15 yet** +(one dependency has no 3.15 wheel; pip would try to compile it and fail). +Nothing compiles: every piece arrives as a prebuilt wheel on Linux, macOS +(Apple Silicon and Intel) and Windows. Pick your machine and follow the steps +top to bottom. **Windows — recommended: WSL2 (Ubuntu inside Windows)** @@ -84,10 +86,8 @@ and follow the steps top to bottom. **Windows — native, no WSL2** -1. Install **Python 3.13** from the Microsoft Store, or from +1. Install **Python 3.13** (not 3.15) from the Microsoft Store, or from with *Add python.exe to PATH* ticked. - Not 3.15: one dependency has no Windows wheel for it yet, so pip tries to - compile and fails on a stock machine. 2. Start menu → `PowerShell`. 3. ```powershell pip install sidepit @@ -98,8 +98,8 @@ and follow the steps top to bottom. **macOS (Apple Silicon or Intel)** -1. Install Python from (the `.pkg` - installer). No Xcode tools, no Homebrew needed. +1. Install **Python 3.13** (not 3.15) from + (the `.pkg` installer). No Xcode tools, no Homebrew needed. 2. Open a **new** Terminal window (Applications → Utilities → Terminal): ```sh pip3 install sidepit From 1ab723dfa342cfbc8138a8ce3411decfd80d8203 Mon Sep 17 00:00:00 2001 From: Jay Berg Date: Fri, 30 Oct 2026 13:53:15 -0700 Subject: [PATCH 4/9] =?UTF-8?q?docs:=20newbie=20quick=20start=20=E2=80=94?= =?UTF-8?q?=20download=20Python=203.13,=20open=20a=20terminal,=20pip=20ins?= =?UTF-8?q?tall=20sidepit?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 23 ++++++++--------------- 1 file changed, 8 insertions(+), 15 deletions(-) diff --git a/README.md b/README.md index c3d8b87..9de2524 100644 --- a/README.md +++ b/README.md @@ -57,11 +57,7 @@ sending straight to the lock address does not identify the intended account. ## Claude + Sidepit: two terminals -**Step 1 — install the cockpit.** Python 3.10 to 3.14 — **not 3.15 yet** -(one dependency has no 3.15 wheel; pip would try to compile it and fail). -Nothing compiles: every piece arrives as a prebuilt wheel on Linux, macOS -(Apple Silicon and Intel) and Windows. Pick your machine and follow the steps -top to bottom. +**Step 1 — install the cockpit.** Pick your machine, follow the steps. **Windows — recommended: WSL2 (Ubuntu inside Windows)** @@ -86,27 +82,24 @@ top to bottom. **Windows — native, no WSL2** -1. Install **Python 3.13** (not 3.15) from the Microsoft Store, or from - with *Add python.exe to PATH* ticked. +1. Download and install Python 3.13: + + — tick *Add python.exe to PATH* on the first screen. 2. Start menu → `PowerShell`. 3. ```powershell pip install sidepit sidepit ``` - If `sidepit` is not found, run `python -m sidepit_tui` instead. Windows - Terminal renders the cockpit best. Keys live in `%USERPROFILE%\.sidepit\keys`. **macOS (Apple Silicon or Intel)** -1. Install **Python 3.13** (not 3.15) from - (the `.pkg` installer). No Xcode tools, no Homebrew needed. -2. Open a **new** Terminal window (Applications → Utilities → Terminal): - ```sh +1. Download and install Python 3.13: + +2. Open Terminal (Applications → Utilities → Terminal). +3. ```sh pip3 install sidepit sidepit ``` - Already on Homebrew? `brew install pipx && pipx install sidepit && pipx ensurepath`, - then reopen Terminal. **Linux (Ubuntu / Debian)** From 551732e4d22f039c90bccf192e6637a3416a3e33 Mon Sep 17 00:00:00 2001 From: Jay Berg Date: Fri, 30 Oct 2026 21:14:57 -0700 Subject: [PATCH 5/9] =?UTF-8?q?docs:=20macOS=20=E2=80=94=20run=20Install?= =?UTF-8?q?=20Certificates=20after=20installing=20Python?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 9de2524..8a4a072 100644 --- a/README.md +++ b/README.md @@ -95,8 +95,10 @@ sending straight to the lock address does not identify the intended account. 1. Download and install Python 3.13: -2. Open Terminal (Applications → Utilities → Terminal). -3. ```sh +2. When the installer finishes it opens the *Python 3.13* folder. Double-click + `Install Certificates.command` in it. +3. Open Terminal (Applications → Utilities → Terminal). +4. ```sh pip3 install sidepit sidepit ``` From 2a888253a8b4d7b8439ddd241ad01f284e2ca7c6 Mon Sep 17 00:00:00 2001 From: Jay Berg Date: Fri, 30 Oct 2026 21:18:10 -0700 Subject: [PATCH 6/9] =?UTF-8?q?docs:=20bring=20your=20agent=20=E2=80=94=20?= =?UTF-8?q?Claude=20Code,=20Codex,=20web,=20or=20any=20agent?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 22 +++++++++++++++++++--- 1 file changed, 19 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 8a4a072..d3b13d1 100644 --- a/README.md +++ b/README.md @@ -115,7 +115,23 @@ Reopen the terminal, run `sidepit`. Other distros: `pip install sidepit` inside First run opens on the live market with no identity. Create, import or watch one from the doors, or press Escape to just look and add a key later with ctrl+a. -**Step 2 — clone the skills** (Claude reads them; the cockpit does not need them): +**Step 2 — bring your agent.** Claude Code and Codex are the ones we test with; +any agent that can read a repo works. Pick one: + +- **Claude Code** (terminal; also built into the Claude desktop app): + ```sh + npm install -g @anthropic-ai/claude-code + ``` +- **Codex** (terminal; also the Codex desktop app): + ```sh + npm install -g @openai/codex + ``` +- **No install — the web:** open claude.ai or chatgpt.com and paste: + > Read https://github.com/sidepit/Public-API/blob/main/AGENTS.md and onboard me. +- **Any other agent or open-source CLI model:** point it at this repo's `AGENTS.md`. + +**Step 3 — two terminals.** Clone the repo (your agent reads the playbooks in it; +the cockpit does not need them): ```sh git clone --recurse-submodules https://github.com/sidepit/Public-API @@ -127,14 +143,14 @@ Terminal one — the cockpit: sidepit ``` -Terminal two — Claude with the Sidepit playbook: +Terminal two — your agent, inside the repo (`claude` or `codex`): ```sh cd Public-API claude ``` -Tell Claude: +Tell it: > Read `skills/sidepit-onboarding/SKILL.md` and onboard me. From f95690415b32314f6390249f5356f1d17443e87b Mon Sep 17 00:00:00 2001 From: Jay Berg Date: Fri, 30 Oct 2026 21:22:48 -0700 Subject: [PATCH 7/9] =?UTF-8?q?docs:=20first=20three=20things=20in=20the?= =?UTF-8?q?=20cockpit=20=E2=80=94=20fund,=20delegate,=20doggie?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index d3b13d1..2684449 100644 --- a/README.md +++ b/README.md @@ -154,7 +154,17 @@ Tell it: > Read `skills/sidepit-onboarding/SKILL.md` and onboard me. -**Claude | Sidepit | make money!** Your key, your sizing, your risk, your call. +**Then, in the cockpit:** + +1. **Fund** — send BTC to your address on the fund tab, then press LOCK. That + opens your account. +2. **Delegate** — ask your agent to generate its own agent key and hand you the + delegate pubkey. Delegates tab → paste it → register. Your agent can now + trade for you; it can never withdraw. +3. **Doggie** — press ctrl+d for the wallet view: more USD or more BTC, two + buttons, you decide. + +Your key, your sizing, your risk, your call. Using Sidepit as a Python SDK? `pip install sidepit` in your project's venv gives your code: From 5149d866bd44f1a1fe38ebbb3a37d27541c15c08 Mon Sep 17 00:00:00 2001 From: Jay Berg Date: Sat, 31 Oct 2026 15:21:19 -0700 Subject: [PATCH 8/9] docs: Node.js prerequisite for terminal agents; web agents skip the clone --- README.md | 17 ++++++++++++----- 1 file changed, 12 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 2684449..fc2989b 100644 --- a/README.md +++ b/README.md @@ -116,7 +116,10 @@ First run opens on the live market with no identity. Create, import or watch one from the doors, or press Escape to just look and add a key later with ctrl+a. **Step 2 — bring your agent.** Claude Code and Codex are the ones we test with; -any agent that can read a repo works. Pick one: +any agent that can read a repo works. The two terminal agents need Node.js, +which brings `npm`: Windows native and macOS install it from +(the LTS installer); WSL2 and Linux run `sudo apt install -y nodejs npm`. The +web option needs nothing. Pick one: - **Claude Code** (terminal; also built into the Claude desktop app): ```sh @@ -128,10 +131,14 @@ any agent that can read a repo works. Pick one: ``` - **No install — the web:** open claude.ai or chatgpt.com and paste: > Read https://github.com/sidepit/Public-API/blob/main/AGENTS.md and onboard me. + + That is your whole Step 3: the browser agent reads the playbooks from GitHub, + so there is nothing to clone. Keep the cockpit in one terminal and the browser + beside it, and go on to **Then, in the cockpit** below. - **Any other agent or open-source CLI model:** point it at this repo's `AGENTS.md`. -**Step 3 — two terminals.** Clone the repo (your agent reads the playbooks in it; -the cockpit does not need them): +**Step 3 — two terminals** (terminal agents only). Clone the repo (your agent +reads the playbooks in it; the cockpit does not need them): ```sh git clone --recurse-submodules https://github.com/sidepit/Public-API @@ -143,11 +150,11 @@ Terminal one — the cockpit: sidepit ``` -Terminal two — your agent, inside the repo (`claude` or `codex`): +Terminal two — your agent, inside the repo: ```sh cd Public-API -claude +claude # or: codex ``` Tell it: From feca0e6037bb6ebd413f4fbf4b0d5205878013a2 Mon Sep 17 00:00:00 2001 From: codex-wip Date: Sat, 31 Oct 2026 15:49:56 -0700 Subject: [PATCH 9/9] docs: separate website and terminal onboarding paths --- README.md | 59 +++++++++++++++++++++++++++++++++---------------------- 1 file changed, 36 insertions(+), 23 deletions(-) diff --git a/README.md b/README.md index fc2989b..f432d81 100644 --- a/README.md +++ b/README.md @@ -55,7 +55,33 @@ The LOCK transaction tells Sidepit which account to credit: its input must spend from the Sidepit ID controlled by the customer. An external wallet or exchange sending straight to the lock address does not identify the intended account. -## Claude + Sidepit: two terminals +## Get started + +Choose the [website](#use-the-website) or the [command-line cockpit](#use-the-command-line-cockpit). + +You can also start by asking your agent to onboard you. Give it the +[onboarding playbook](skills/sidepit-onboarding/SKILL.md) and say: + +> Read https://github.com/sidepit/Public-API/blob/main/skills/sidepit-onboarding/SKILL.md +> and onboard me. Ask whether I prefer the website or the command line. + +The agent should guide your chosen path. A terminal agent can guide you through +the website just as a browser assistant can. + +### Use the website + +Start with the [Sidepit user docs](https://docs.sidepit.com) and open +[the trading app](https://app.sidepit.com). Follow the docs for wallet setup, +funding and authorizing an agent. This path needs no cockpit installation or +repository clone. + +For help in your browser, open [Claude](https://claude.ai) or +[ChatGPT](https://chatgpt.com) and paste the onboarding prompt above, adding +"Use the website." Keep the assistant beside the trading app as you follow the +guide. Agents can read the docs through [llms.txt](https://docs.sidepit.com/llms.txt) +and its linked Markdown pages. + +### Use the command-line cockpit **Step 1 — install the cockpit.** Pick your machine, follow the steps. @@ -115,27 +141,14 @@ Reopen the terminal, run `sidepit`. Other distros: `pip install sidepit` inside First run opens on the live market with no identity. Create, import or watch one from the doors, or press Escape to just look and add a key later with ctrl+a. -**Step 2 — bring your agent.** Claude Code and Codex are the ones we test with; -any agent that can read a repo works. The two terminal agents need Node.js, -which brings `npm`: Windows native and macOS install it from -(the LTS installer); WSL2 and Linux run `sudo apt install -y nodejs npm`. The -web option needs nothing. Pick one: - -- **Claude Code** (terminal; also built into the Claude desktop app): - ```sh - npm install -g @anthropic-ai/claude-code - ``` -- **Codex** (terminal; also the Codex desktop app): - ```sh - npm install -g @openai/codex - ``` -- **No install — the web:** open claude.ai or chatgpt.com and paste: - > Read https://github.com/sidepit/Public-API/blob/main/AGENTS.md and onboard me. - - That is your whole Step 3: the browser agent reads the playbooks from GitHub, - so there is nothing to clone. Keep the cockpit in one terminal and the browser - beside it, and go on to **Then, in the cockpit** below. -- **Any other agent or open-source CLI model:** point it at this repo's `AGENTS.md`. +**Step 2 — bring your terminal agent.** Claude Code and Codex are the ones we +test with. If you already use a terminal agent, continue to Step 3. Otherwise, +follow its official installation guide for your operating system: + +- [Install Claude Code](https://code.claude.com/docs/en/setup), then run `claude`. +- [Install Codex](https://learn.chatgpt.com/docs/codex/cli), then run `codex`. +- For another terminal agent, follow its installation guide and point it at + this repo's `AGENTS.md`. **Step 3 — two terminals** (terminal agents only). Clone the repo (your agent reads the playbooks in it; the cockpit does not need them): @@ -159,7 +172,7 @@ claude # or: codex Tell it: -> Read `skills/sidepit-onboarding/SKILL.md` and onboard me. +> Read `skills/sidepit-onboarding/SKILL.md` and onboard me using the cockpit. **Then, in the cockpit:**