pythinker-code 0.13.0__tar.gz → 0.15.0__tar.gz

{pythinker_code-0.13.0 → pythinker_code-0.15.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pythinker-code
-Version: 0.13.0
+Version: 0.15.0
 Summary: Pythinker Code is your next CLI agent.
 Keywords: cli,agent,ai,coding-assistant,llm,claude,openai,terminal
 Author: Mohamed Elkholy
@@ -80,6 +80,7 @@ Description-Content-Type: text/markdown
 [![CI](https://img.shields.io/github/actions/workflow/status/mohamed-elkholy95/Pythinker-Code/ci-pythinker-cli.yml?branch=main&label=CI&style=for-the-badge&logo=githubactions&logoColor=white)](https://github.com/mohamed-elkholy95/Pythinker-Code/actions/workflows/ci-pythinker-cli.yml?query=branch%3Amain)
 
 [![Downloads](https://img.shields.io/pepy/dt/pythinker-code?cacheSeconds=300)](https://pepy.tech/projects/pythinker-code)
+[![Installs](https://img.shields.io/endpoint?url=https://pythinker.com/api/installs/badge&cacheSeconds=300)](https://pythinker.com)
 [![Code style: Ruff](https://img.shields.io/badge/code%20style-ruff-f59e0b.svg?style=flat-square&logo=ruff&logoColor=white)](https://docs.astral.sh/ruff/)
 [![ACP ready](https://img.shields.io/badge/ACP-ready-7c3aed.svg?style=flat-square)](https://github.com/agentclientprotocol/agent-client-protocol)
 [![MCP tools](https://img.shields.io/badge/MCP-tools-0891b2.svg?style=flat-square)](https://modelcontextprotocol.io/)
@@ -97,7 +98,7 @@ Description-Content-Type: text/markdown
 
 <br /><br />
 
-<img src="https://raw.githubusercontent.com/mohamed-elkholy95/Pythinker-Code/main/docs/media/pythinker-code.gif" alt="Pythinker Code terminal demo" width="860">
+<img src="https://raw.githubusercontent.com/mohamed-elkholy95/Pythinker-Code/main/docs/media/pythinker-cli.gif" alt="Pythinker Code terminal demo" width="860">
 
 </div>
 
@@ -115,15 +116,13 @@ It speaks the [**Agent Client Protocol (ACP)**](https://github.com/agentclientpr
 
 ---
 
-## 🆕 What's New in 0.13.0
+## 🆕 What's New in 0.15.0
 
-- **Native installers for macOS and Linux.** `brew install mohamed-elkholy95/pythinker/pythinker-code` works on both macOS (Intel + Apple Silicon) and Linux brew installs. Debian/Ubuntu users get `pythinker-code_0.13.0_<arch>.deb`, Fedora/RHEL/openSUSE users get `pythinker-code-0.13.0.<arch>.rpm`, both built for `x86_64` and `aarch64`. Together with the Windows `PythinkerSetup-0.13.0.exe` shipped in 0.12.0, Pythinker now has a real native installer on every supported platform.
-- **Cross-OS `install-native.sh`.** `curl -fsSL .../install-native.sh | bash` auto-detects your OS + arch, verifies SHA-256, and lands `pythinker` at `~/.local/bin/`. The script is the no-package-manager fallback for containers and fresh VMs.
-- **Homebrew tap auto-publishes on every release.** A new tag-triggered workflow regenerates `Formula/pythinker-code.rb` (132 transitive deps enumerated automatically) and pushes it to [mohamed-elkholy95/homebrew-pythinker](https://github.com/mohamed-elkholy95/homebrew-pythinker). `brew upgrade pythinker-code` picks up new versions; no hand-curation per release.
-- **Frozen-binary fix for 0.12.0's installer.** The PyInstaller specs now bundle every `.md` / `.yaml` package data file (`prompts/`, `agents/`, `tools/*/description.md`, `skills/*/SKILL.md`). 0.12.0's Windows installer crashed on first prompt load — **upgrade to 0.13.0** to fix it.
-- **Legacy install paths deprecated.** The helper shell scripts (`install.sh`, `install.ps1`), `uvx`, `uv tool install`, `pipx install`, and bare `pip install` keep working but are now flagged as legacy. README Quick Start leads with the per-OS native installer table. Set `PYTHINKER_INSTALL_QUIET_DEPRECATION=1` to silence the deprecation banner in the helper scripts.
+- **Native updater fixed for curl-bash installs.** `pythinker update` now recognizes PyInstaller-frozen `~/.local/bin/pythinker` binaries as native installs even when older onefile tarballs lack the `.pythinker-native` sentinel.
+- **Unix native updates pull release archives directly.** On Linux and Apple Silicon macOS, `pythinker update` downloads the matching `pythinker-0.15.0-<target>.tar.gz`, verifies its `.sha256`, and replaces the current native binary instead of trying to run `pythinker -m pip install`.
+- **Clearer fallback guidance.** Native update banners now point Unix users at the canonical `curl -fsSL https://pythinker.com/install.sh | bash -s -- --version 0.15.0` command, while Windows still points at the native setup executable.
 
-Upgrade with `pythinker update`, `pip install --upgrade pythinker-code==0.13.0`, or use the native installer for your platform from the [Releases page](https://github.com/mohamed-elkholy95/Pythinker-Code/releases/latest).
+Upgrade with `pythinker update`, `pip install --upgrade pythinker-code==0.15.0`, or use the native installer for your platform from the [Releases page](https://github.com/mohamed-elkholy95/Pythinker-Code/releases/latest).
 
 
 ---
@@ -168,7 +167,7 @@ Manage stdio and HTTP MCP servers with `pythinker mcp`. OAuth-backed servers, pe
 
 ### 🤖 Subagents & Skills
 
-Delegate focused work to built-in subagents. Load reusable instructions via `/skill:<name>` and bundled prompt flows via `/flow:<name>`.
+Delegate focused work to built-in subagents. Load reusable instructions via `/skill:<name>` and bundled prompt flows via `/flow:<name>`. Use `pythinker skill list`, `pythinker skill lock`, and `pythinker skill verify-lock` to inspect project skills and pin their hashes in `skills-lock.json`.
 
 </td>
 <td width="50%" valign="top">
@@ -213,94 +212,189 @@ matches your OS — no Python, Node, or `uv` prerequisite.
 
 | Platform | One-line install | Artifact |
 |---|---|---|
-| **🪟 Windows** | Download + double-click `PythinkerSetup-x.y.z.exe` | [Releases](https://github.com/mohamed-elkholy95/Pythinker-Code/releases/latest) |
+| **🪟 Windows** | `irm https://pythinker.com/install.ps1 \| iex` | native `.exe` installer |
 | **🍎 macOS (Apple Silicon + Intel)** | `brew install mohamed-elkholy95/pythinker/pythinker-code` | Homebrew tap |
-| **🐧 Linux (Debian / Ubuntu)** | `sudo dpkg -i pythinker-code_x.y.z_amd64.deb` | [Releases](https://github.com/mohamed-elkholy95/Pythinker-Code/releases/latest) |
-| **🐧 Linux (Fedora / RHEL / openSUSE)** | `sudo rpm -i pythinker-code-x.y.z.x86_64.rpm` | [Releases](https://github.com/mohamed-elkholy95/Pythinker-Code/releases/latest) |
-| **🌐 macOS / Linux — curl-bash** | `curl -fsSL https://raw.githubusercontent.com/mohamed-elkholy95/Pythinker-Code/main/scripts/install-native.sh \| bash` | tarball |
+| **🐧 Linux (Debian / Ubuntu)** | `sudo dpkg -i pythinker-code_0.15.0_amd64.deb` | [Releases](https://github.com/mohamed-elkholy95/Pythinker-Code/releases/latest) |
+| **🐧 Linux (Fedora / RHEL)** | Download `pythinker-code-0.15.0.x86_64.rpm`, then `sudo dnf install ./pythinker-code-0.15.0.x86_64.rpm` | [Releases](https://github.com/mohamed-elkholy95/Pythinker-Code/releases/latest) |
+| **🐧 Linux (openSUSE)** | Download `pythinker-code-0.15.0.x86_64.rpm`, then `sudo zypper install ./pythinker-code-0.15.0.x86_64.rpm` | [Releases](https://github.com/mohamed-elkholy95/Pythinker-Code/releases/latest) |
+| **🌐 macOS / Linux — curl-bash** | `curl -fsSL https://pythinker.com/install.sh \| bash` | tarball |
+| **🐍 Python fallback** (universal) | `pip install pythinker-code` | PyPI |
 
-> **Updates** — Once installed, `pythinker update` checks the GitHub Releases
-> API, verifies the new artifact's SHA-256, and re-runs the installer for you.
-> Set `PYTHINKER_CLI_NO_AUTO_UPDATE=1` to disable the startup update check.
+Every artifact ships with a matching `.sha256` file — verify before install on
+any platform with `sha256sum`, `shasum -a 256`, or `Get-FileHash`.
 
-> **Verifying downloads** — Every artifact ships with a matching `.sha256`
-> file. Verify before installing with `sha256sum`, `shasum -a 256`, or
-> PowerShell's `Get-FileHash` (see platform sections below).
+After install, on any OS:
 
-### 🪟 Windows native installer — details
+```sh
+pythinker --version            # confirm install
+pythinker login                # (optional) authenticate a hosted provider
+pythinker                      # start the interactive TUI
+```
+
+> **In-app updates** — `pythinker update` queries the GitHub Releases API and
+> re-runs the right installer for your build with SHA-256 verification. Set
+> `PYTHINKER_CLI_NO_AUTO_UPDATE=1` to disable the proactive startup check.
+
+---
 
-`PythinkerSetup-x.y.z.exe` installs per-user to `%LOCALAPPDATA%\Programs\Pythinker`
-and adds `pythinker` to your user PATH (`HKCU\Environment`). No UAC prompt.
+### 🪟 Windows — native installer
+
+`PythinkerSetup-0.15.0.exe` is a signed* Inno Setup wizard. Installs per-user
+into `%LOCALAPPDATA%\Programs\Pythinker`, registers `pythinker` on your user
+PATH (`HKCU\Environment`), broadcasts `WM_SETTINGCHANGE` so new shells see
+the change. **No UAC prompt.**
 
 ```powershell
-# 1. Verify the download
-Get-FileHash .\PythinkerSetup-x.y.z.exe -Algorithm SHA256
-Get-Content  .\PythinkerSetup-x.y.z.exe.sha256
+# One-line install (downloads the native .exe, verifies SHA-256, runs per-user)
+irm https://pythinker.com/install.ps1 | iex
 
-# 2. Run the installer (double-click also works)
-.\PythinkerSetup-x.y.z.exe
+# Or manually download the installer + checksum from the Releases page,
+# verify with Get-FileHash, then run:
+.\PythinkerSetup-0.15.0.exe
 
-# 3. Open a fresh PowerShell
+# Open a fresh PowerShell
 pythinker --version
 ```
 
-**Per-machine install** (IT-managed boxes): `.\PythinkerSetup-x.y.z.exe /ALLUSERS`
-installs to `%ProgramFiles%\Pythinker` and writes to HKLM.
+**Per-machine install** (IT-managed boxes): `.\PythinkerSetup-0.15.0.exe /ALLUSERS`
+installs to `%ProgramFiles%\Pythinker` and writes PATH to HKLM (requires admin).
+
+**Upgrade:** `pythinker update` from inside the running app — it downloads
+the newest installer, verifies SHA-256, and re-runs it silently
+(`/VERYSILENT /SUPPRESSMSGBOXES /NORESTART`).
 
-**Uninstall:** Apps & Features → *Pythinker Code* → Uninstall reverts both the
-files and the PATH edit.
+**Uninstall:** Apps & Features → *Pythinker Code* → Uninstall reverts both
+the files and the PATH edit.
 
-> 🛡 **First-launch SmartScreen warning** — until the Authenticode cert is in
-> CI, the installer ships unsigned and SmartScreen shows *"Windows protected
-> your PC."* Click **More info → Run anyway**. Use the published SHA-256 as
-> your integrity check.
+> 🛡 **First-launch SmartScreen warning** — \*until the Authenticode cert is
+> provisioned in CI, the installer ships unsigned and Windows shows
+> *"Windows protected your PC."* Click **More info → Run anyway**. Use the
+> published `.sha256` as your integrity check until signing comes online.
 
-### 🍎 macOS — Homebrew
+---
+
+### 🍎 macOS — Homebrew tap
 
 ```sh
+# 1. Install
 brew install mohamed-elkholy95/pythinker/pythinker-code
-brew upgrade pythinker-code   # manual updates; brew packages don't auto-update
+
+# 2. Verify
+pythinker --version
+which pythinker          # -> /opt/homebrew/bin/pythinker (Apple Silicon)
+                         #    or /usr/local/bin/pythinker (Intel)
 ```
 
-Drops `pythinker` at `$(brew --prefix)/bin/pythinker`. Works on Apple Silicon
-and Intel; brew picks the right Python build for you.
+Works on **Apple Silicon and Intel** — brew picks the right Python build for
+you. The tap auto-publishes a fresh formula on every Pythinker release, so
+`brew upgrade pythinker-code` always finds the latest version.
+
+**Upgrade:** `brew upgrade pythinker-code` (Homebrew packages don't
+auto-update; run this whenever you want the latest).
+
+**Uninstall:** `brew uninstall pythinker-code && brew untap mohamed-elkholy95/pythinker`.
+
+> The tap repo is [mohamed-elkholy95/homebrew-pythinker](https://github.com/mohamed-elkholy95/homebrew-pythinker)
+> — auto-maintained, do not hand-edit.
+
+---
 
 ### 🐧 Linux — system packages
 
-Native packages are attached to every GitHub Release. Both `.deb` and `.rpm`
-are built for `x86_64` and `aarch64`:
+Native `.deb` and `.rpm` packages for both `x86_64` and `aarch64` are
+attached to every GitHub Release.
+
+```sh
+# Debian / Ubuntu (x86_64)
+sudo dpkg -i pythinker-code_0.15.0_amd64.deb
+sudo apt-get install -f       # only if dpkg reports missing deps
+
+# Debian / Ubuntu (ARM64)
+sudo dpkg -i pythinker-code_0.15.0_arm64.deb
+
+# Fedora / RHEL / openSUSE (x86_64)
+curl -LO https://github.com/mohamed-elkholy95/Pythinker-Code/releases/download/v0.15.0/pythinker-code-0.15.0.x86_64.rpm
+curl -LO https://github.com/mohamed-elkholy95/Pythinker-Code/releases/download/v0.15.0/pythinker-code-0.15.0.x86_64.rpm.sha256
+sha256sum -c pythinker-code-0.15.0.x86_64.rpm.sha256
+# Fedora / RHEL:
+sudo dnf install ./pythinker-code-0.15.0.x86_64.rpm
+# openSUSE:
+sudo zypper install ./pythinker-code-0.15.0.x86_64.rpm
+
+# Fedora / RHEL (aarch64)
+curl -LO https://github.com/mohamed-elkholy95/Pythinker-Code/releases/download/v0.15.0/pythinker-code-0.15.0.aarch64.rpm
+curl -LO https://github.com/mohamed-elkholy95/Pythinker-Code/releases/download/v0.15.0/pythinker-code-0.15.0.aarch64.rpm.sha256
+sha256sum -c pythinker-code-0.15.0.aarch64.rpm.sha256
+sudo dnf install ./pythinker-code-0.15.0.aarch64.rpm
+```
+
+Both packages drop a small `/usr/bin/pythinker` launcher that execs the real
+binary under `/usr/lib/pythinker/`, so your `$PATH` stays tidy.
+
+**Verify before install:**
 
 ```sh
-# Debian / Ubuntu
-sudo dpkg -i pythinker-code_x.y.z_amd64.deb
-# If apt complains about missing deps:
-sudo apt-get install -f
+sha256sum -c pythinker-code_0.15.0_amd64.deb.sha256        # Debian/Ubuntu
+sha256sum -c pythinker-code-0.15.0.x86_64.rpm.sha256       # Fedora/RHEL
+```
+
+**Upgrade:** download the new `.deb`/`.rpm` from Releases and `dpkg -i` /
+`dnf install` over it. Or run `pythinker update` from inside the running
+app — it'll fetch the matching new package and prompt for sudo to install.
+
+**Uninstall:**
 
-# Fedora / RHEL / openSUSE
-sudo rpm -i pythinker-code-x.y.z.x86_64.rpm
-# or:
-sudo dnf install ./pythinker-code-x.y.z.x86_64.rpm
+```sh
+sudo dpkg -r pythinker-code                                # Debian/Ubuntu
+sudo rpm -e pythinker-code                                 # Fedora/RHEL
 ```
 
-Both packages drop `/usr/bin/pythinker` (a small launcher that execs the real
-binary under `/usr/lib/pythinker/`).
+---
 
 ### 🌐 macOS / Linux — curl-bash native installer
 
-For machines without a package manager (containers, fresh VMs), the
-[install-native.sh](./scripts/install-native.sh) helper downloads the right
-tarball for your OS + arch, verifies SHA-256, and installs to `~/.local/`.
+For containers, fresh VMs, or any host without a system package manager.
+The canonical `https://pythinker.com/install.sh` endpoint is backed by
+[`scripts/install-native.sh`](./scripts/install-native.sh). It serves shell
+script content directly, detects your OS + arch, downloads the matching
+PyInstaller-frozen tarball, verifies its SHA-256, and lands the single binary
+at `~/.local/bin/pythinker`.
 
 ```sh
-curl -fsSL https://raw.githubusercontent.com/mohamed-elkholy95/Pythinker-Code/main/scripts/install-native.sh | bash
+# Latest release
+curl -fsSL https://pythinker.com/install.sh | bash
 
-# Pin a specific version:
-curl -fsSL ...install-native.sh | bash -s -- --version 0.13.0
+# Pin a specific version
+curl -fsSL https://pythinker.com/install.sh | bash -s -- --version 0.15.0
+
+# Custom prefix (defaults to $HOME/.local)
+curl -fsSL https://pythinker.com/install.sh | bash -s -- --prefix /opt/pythinker
 ```
 
-The script lands the binary at `~/.local/share/pythinker/` and symlinks
-`~/.local/bin/pythinker`. It prints PATH guidance if `~/.local/bin` isn't on
-your `$PATH`.
+Host `/install.sh` with:
+
+```http
+Content-Type: text/x-shellscript; charset=utf-8
+Cache-Control: public, max-age=300, s-maxage=900, stale-if-error=86400
+```
+
+Use long immutable caching only for versioned release artifact URLs, for
+example `Cache-Control: public, max-age=31536000, immutable` on fixed-tag
+assets.
+
+Supported targets:
+
+| `uname -s / -m`             | Tarball asset                                            |
+|---|---|
+| Linux / x86_64              | `pythinker-0.15.0-x86_64-unknown-linux-gnu.tar.gz`        |
+| Linux / aarch64             | `pythinker-0.15.0-aarch64-unknown-linux-gnu.tar.gz`       |
+| Darwin / arm64              | `pythinker-0.15.0-aarch64-apple-darwin.tar.gz`            |
+
+The script prints PATH guidance if `~/.local/bin` isn't already on your
+`$PATH`. Intel macOS users — use Homebrew or `pip install pythinker-code`;
+no PyInstaller-built Intel Darwin binary is published.
+
+**Uninstall:** `rm ~/.local/bin/pythinker`.
 
 ### 🛠 Power-user / legacy install paths
 
@@ -313,13 +407,10 @@ your `$PATH`.
 <summary>Legacy shell-script wrappers + uv / pipx</summary>
 
 ```sh
-# Legacy: uv-based shell-script wrappers (prints a deprecation banner on run)
-curl -fsSL https://raw.githubusercontent.com/mohamed-elkholy95/Pythinker-Code/main/scripts/install.sh | bash
-# Windows PowerShell wrapper:
-$installer = Join-Path $env:TEMP "pythinker-install.ps1"
-iwr -UseBasicParsing https://raw.githubusercontent.com/mohamed-elkholy95/Pythinker-Code/main/scripts/install.ps1 -OutFile $installer
-& $installer
-Remove-Item $installer
+# Compatibility shim to the native installer
+scripts/install.sh
+# Windows PowerShell native installer bootstrap:
+powershell -c "irm https://pythinker.com/install.ps1 | iex"
 
 # Legacy: one-off run via uvx
 uvx pythinker-code

{pythinker_code-0.13.0 → pythinker_code-0.15.0}/README.md

@@ -15,6 +15,7 @@
 [![CI](https://img.shields.io/github/actions/workflow/status/mohamed-elkholy95/Pythinker-Code/ci-pythinker-cli.yml?branch=main&label=CI&style=for-the-badge&logo=githubactions&logoColor=white)](https://github.com/mohamed-elkholy95/Pythinker-Code/actions/workflows/ci-pythinker-cli.yml?query=branch%3Amain)
 
 [![Downloads](https://img.shields.io/pepy/dt/pythinker-code?cacheSeconds=300)](https://pepy.tech/projects/pythinker-code)
+[![Installs](https://img.shields.io/endpoint?url=https://pythinker.com/api/installs/badge&cacheSeconds=300)](https://pythinker.com)
 [![Code style: Ruff](https://img.shields.io/badge/code%20style-ruff-f59e0b.svg?style=flat-square&logo=ruff&logoColor=white)](https://docs.astral.sh/ruff/)
 [![ACP ready](https://img.shields.io/badge/ACP-ready-7c3aed.svg?style=flat-square)](https://github.com/agentclientprotocol/agent-client-protocol)
 [![MCP tools](https://img.shields.io/badge/MCP-tools-0891b2.svg?style=flat-square)](https://modelcontextprotocol.io/)
@@ -32,7 +33,7 @@
 
 <br /><br />
 
-<img src="https://raw.githubusercontent.com/mohamed-elkholy95/Pythinker-Code/main/docs/media/pythinker-code.gif" alt="Pythinker Code terminal demo" width="860">
+<img src="https://raw.githubusercontent.com/mohamed-elkholy95/Pythinker-Code/main/docs/media/pythinker-cli.gif" alt="Pythinker Code terminal demo" width="860">
 
 </div>
 
@@ -50,15 +51,13 @@ It speaks the [**Agent Client Protocol (ACP)**](https://github.com/agentclientpr
 
 ---
 
-## 🆕 What's New in 0.13.0
+## 🆕 What's New in 0.15.0
 
-- **Native installers for macOS and Linux.** `brew install mohamed-elkholy95/pythinker/pythinker-code` works on both macOS (Intel + Apple Silicon) and Linux brew installs. Debian/Ubuntu users get `pythinker-code_0.13.0_<arch>.deb`, Fedora/RHEL/openSUSE users get `pythinker-code-0.13.0.<arch>.rpm`, both built for `x86_64` and `aarch64`. Together with the Windows `PythinkerSetup-0.13.0.exe` shipped in 0.12.0, Pythinker now has a real native installer on every supported platform.
-- **Cross-OS `install-native.sh`.** `curl -fsSL .../install-native.sh | bash` auto-detects your OS + arch, verifies SHA-256, and lands `pythinker` at `~/.local/bin/`. The script is the no-package-manager fallback for containers and fresh VMs.
-- **Homebrew tap auto-publishes on every release.** A new tag-triggered workflow regenerates `Formula/pythinker-code.rb` (132 transitive deps enumerated automatically) and pushes it to [mohamed-elkholy95/homebrew-pythinker](https://github.com/mohamed-elkholy95/homebrew-pythinker). `brew upgrade pythinker-code` picks up new versions; no hand-curation per release.
-- **Frozen-binary fix for 0.12.0's installer.** The PyInstaller specs now bundle every `.md` / `.yaml` package data file (`prompts/`, `agents/`, `tools/*/description.md`, `skills/*/SKILL.md`). 0.12.0's Windows installer crashed on first prompt load — **upgrade to 0.13.0** to fix it.
-- **Legacy install paths deprecated.** The helper shell scripts (`install.sh`, `install.ps1`), `uvx`, `uv tool install`, `pipx install`, and bare `pip install` keep working but are now flagged as legacy. README Quick Start leads with the per-OS native installer table. Set `PYTHINKER_INSTALL_QUIET_DEPRECATION=1` to silence the deprecation banner in the helper scripts.
+- **Native updater fixed for curl-bash installs.** `pythinker update` now recognizes PyInstaller-frozen `~/.local/bin/pythinker` binaries as native installs even when older onefile tarballs lack the `.pythinker-native` sentinel.
+- **Unix native updates pull release archives directly.** On Linux and Apple Silicon macOS, `pythinker update` downloads the matching `pythinker-0.15.0-<target>.tar.gz`, verifies its `.sha256`, and replaces the current native binary instead of trying to run `pythinker -m pip install`.
+- **Clearer fallback guidance.** Native update banners now point Unix users at the canonical `curl -fsSL https://pythinker.com/install.sh | bash -s -- --version 0.15.0` command, while Windows still points at the native setup executable.
 
-Upgrade with `pythinker update`, `pip install --upgrade pythinker-code==0.13.0`, or use the native installer for your platform from the [Releases page](https://github.com/mohamed-elkholy95/Pythinker-Code/releases/latest).
+Upgrade with `pythinker update`, `pip install --upgrade pythinker-code==0.15.0`, or use the native installer for your platform from the [Releases page](https://github.com/mohamed-elkholy95/Pythinker-Code/releases/latest).
 
 
 ---
@@ -103,7 +102,7 @@ Manage stdio and HTTP MCP servers with `pythinker mcp`. OAuth-backed servers, pe
 
 ### 🤖 Subagents & Skills
 
-Delegate focused work to built-in subagents. Load reusable instructions via `/skill:<name>` and bundled prompt flows via `/flow:<name>`.
+Delegate focused work to built-in subagents. Load reusable instructions via `/skill:<name>` and bundled prompt flows via `/flow:<name>`. Use `pythinker skill list`, `pythinker skill lock`, and `pythinker skill verify-lock` to inspect project skills and pin their hashes in `skills-lock.json`.
 
 </td>
 <td width="50%" valign="top">
@@ -148,94 +147,189 @@ matches your OS — no Python, Node, or `uv` prerequisite.
 
 | Platform | One-line install | Artifact |
 |---|---|---|
-| **🪟 Windows** | Download + double-click `PythinkerSetup-x.y.z.exe` | [Releases](https://github.com/mohamed-elkholy95/Pythinker-Code/releases/latest) |
+| **🪟 Windows** | `irm https://pythinker.com/install.ps1 \| iex` | native `.exe` installer |
 | **🍎 macOS (Apple Silicon + Intel)** | `brew install mohamed-elkholy95/pythinker/pythinker-code` | Homebrew tap |
-| **🐧 Linux (Debian / Ubuntu)** | `sudo dpkg -i pythinker-code_x.y.z_amd64.deb` | [Releases](https://github.com/mohamed-elkholy95/Pythinker-Code/releases/latest) |
-| **🐧 Linux (Fedora / RHEL / openSUSE)** | `sudo rpm -i pythinker-code-x.y.z.x86_64.rpm` | [Releases](https://github.com/mohamed-elkholy95/Pythinker-Code/releases/latest) |
-| **🌐 macOS / Linux — curl-bash** | `curl -fsSL https://raw.githubusercontent.com/mohamed-elkholy95/Pythinker-Code/main/scripts/install-native.sh \| bash` | tarball |
+| **🐧 Linux (Debian / Ubuntu)** | `sudo dpkg -i pythinker-code_0.15.0_amd64.deb` | [Releases](https://github.com/mohamed-elkholy95/Pythinker-Code/releases/latest) |
+| **🐧 Linux (Fedora / RHEL)** | Download `pythinker-code-0.15.0.x86_64.rpm`, then `sudo dnf install ./pythinker-code-0.15.0.x86_64.rpm` | [Releases](https://github.com/mohamed-elkholy95/Pythinker-Code/releases/latest) |
+| **🐧 Linux (openSUSE)** | Download `pythinker-code-0.15.0.x86_64.rpm`, then `sudo zypper install ./pythinker-code-0.15.0.x86_64.rpm` | [Releases](https://github.com/mohamed-elkholy95/Pythinker-Code/releases/latest) |
+| **🌐 macOS / Linux — curl-bash** | `curl -fsSL https://pythinker.com/install.sh \| bash` | tarball |
+| **🐍 Python fallback** (universal) | `pip install pythinker-code` | PyPI |
 
-> **Updates** — Once installed, `pythinker update` checks the GitHub Releases
-> API, verifies the new artifact's SHA-256, and re-runs the installer for you.
-> Set `PYTHINKER_CLI_NO_AUTO_UPDATE=1` to disable the startup update check.
+Every artifact ships with a matching `.sha256` file — verify before install on
+any platform with `sha256sum`, `shasum -a 256`, or `Get-FileHash`.
 
-> **Verifying downloads** — Every artifact ships with a matching `.sha256`
-> file. Verify before installing with `sha256sum`, `shasum -a 256`, or
-> PowerShell's `Get-FileHash` (see platform sections below).
+After install, on any OS:
 
-### 🪟 Windows native installer — details
+```sh
+pythinker --version            # confirm install
+pythinker login                # (optional) authenticate a hosted provider
+pythinker                      # start the interactive TUI
+```
+
+> **In-app updates** — `pythinker update` queries the GitHub Releases API and
+> re-runs the right installer for your build with SHA-256 verification. Set
+> `PYTHINKER_CLI_NO_AUTO_UPDATE=1` to disable the proactive startup check.
+
+---
 
-`PythinkerSetup-x.y.z.exe` installs per-user to `%LOCALAPPDATA%\Programs\Pythinker`
-and adds `pythinker` to your user PATH (`HKCU\Environment`). No UAC prompt.
+### 🪟 Windows — native installer
+
+`PythinkerSetup-0.15.0.exe` is a signed* Inno Setup wizard. Installs per-user
+into `%LOCALAPPDATA%\Programs\Pythinker`, registers `pythinker` on your user
+PATH (`HKCU\Environment`), broadcasts `WM_SETTINGCHANGE` so new shells see
+the change. **No UAC prompt.**
 
 ```powershell
-# 1. Verify the download
-Get-FileHash .\PythinkerSetup-x.y.z.exe -Algorithm SHA256
-Get-Content  .\PythinkerSetup-x.y.z.exe.sha256
+# One-line install (downloads the native .exe, verifies SHA-256, runs per-user)
+irm https://pythinker.com/install.ps1 | iex
 
-# 2. Run the installer (double-click also works)
-.\PythinkerSetup-x.y.z.exe
+# Or manually download the installer + checksum from the Releases page,
+# verify with Get-FileHash, then run:
+.\PythinkerSetup-0.15.0.exe
 
-# 3. Open a fresh PowerShell
+# Open a fresh PowerShell
 pythinker --version
 ```
 
-**Per-machine install** (IT-managed boxes): `.\PythinkerSetup-x.y.z.exe /ALLUSERS`
-installs to `%ProgramFiles%\Pythinker` and writes to HKLM.
+**Per-machine install** (IT-managed boxes): `.\PythinkerSetup-0.15.0.exe /ALLUSERS`
+installs to `%ProgramFiles%\Pythinker` and writes PATH to HKLM (requires admin).
+
+**Upgrade:** `pythinker update` from inside the running app — it downloads
+the newest installer, verifies SHA-256, and re-runs it silently
+(`/VERYSILENT /SUPPRESSMSGBOXES /NORESTART`).
 
-**Uninstall:** Apps & Features → *Pythinker Code* → Uninstall reverts both the
-files and the PATH edit.
+**Uninstall:** Apps & Features → *Pythinker Code* → Uninstall reverts both
+the files and the PATH edit.
 
-> 🛡 **First-launch SmartScreen warning** — until the Authenticode cert is in
-> CI, the installer ships unsigned and SmartScreen shows *"Windows protected
-> your PC."* Click **More info → Run anyway**. Use the published SHA-256 as
-> your integrity check.
+> 🛡 **First-launch SmartScreen warning** — \*until the Authenticode cert is
+> provisioned in CI, the installer ships unsigned and Windows shows
+> *"Windows protected your PC."* Click **More info → Run anyway**. Use the
+> published `.sha256` as your integrity check until signing comes online.
 
-### 🍎 macOS — Homebrew
+---
+
+### 🍎 macOS — Homebrew tap
 
 ```sh
+# 1. Install
 brew install mohamed-elkholy95/pythinker/pythinker-code
-brew upgrade pythinker-code   # manual updates; brew packages don't auto-update
+
+# 2. Verify
+pythinker --version
+which pythinker          # -> /opt/homebrew/bin/pythinker (Apple Silicon)
+                         #    or /usr/local/bin/pythinker (Intel)
 ```
 
-Drops `pythinker` at `$(brew --prefix)/bin/pythinker`. Works on Apple Silicon
-and Intel; brew picks the right Python build for you.
+Works on **Apple Silicon and Intel** — brew picks the right Python build for
+you. The tap auto-publishes a fresh formula on every Pythinker release, so
+`brew upgrade pythinker-code` always finds the latest version.
+
+**Upgrade:** `brew upgrade pythinker-code` (Homebrew packages don't
+auto-update; run this whenever you want the latest).
+
+**Uninstall:** `brew uninstall pythinker-code && brew untap mohamed-elkholy95/pythinker`.
+
+> The tap repo is [mohamed-elkholy95/homebrew-pythinker](https://github.com/mohamed-elkholy95/homebrew-pythinker)
+> — auto-maintained, do not hand-edit.
+
+---
 
 ### 🐧 Linux — system packages
 
-Native packages are attached to every GitHub Release. Both `.deb` and `.rpm`
-are built for `x86_64` and `aarch64`:
+Native `.deb` and `.rpm` packages for both `x86_64` and `aarch64` are
+attached to every GitHub Release.
+
+```sh
+# Debian / Ubuntu (x86_64)
+sudo dpkg -i pythinker-code_0.15.0_amd64.deb
+sudo apt-get install -f       # only if dpkg reports missing deps
+
+# Debian / Ubuntu (ARM64)
+sudo dpkg -i pythinker-code_0.15.0_arm64.deb
+
+# Fedora / RHEL / openSUSE (x86_64)
+curl -LO https://github.com/mohamed-elkholy95/Pythinker-Code/releases/download/v0.15.0/pythinker-code-0.15.0.x86_64.rpm
+curl -LO https://github.com/mohamed-elkholy95/Pythinker-Code/releases/download/v0.15.0/pythinker-code-0.15.0.x86_64.rpm.sha256
+sha256sum -c pythinker-code-0.15.0.x86_64.rpm.sha256
+# Fedora / RHEL:
+sudo dnf install ./pythinker-code-0.15.0.x86_64.rpm
+# openSUSE:
+sudo zypper install ./pythinker-code-0.15.0.x86_64.rpm
+
+# Fedora / RHEL (aarch64)
+curl -LO https://github.com/mohamed-elkholy95/Pythinker-Code/releases/download/v0.15.0/pythinker-code-0.15.0.aarch64.rpm
+curl -LO https://github.com/mohamed-elkholy95/Pythinker-Code/releases/download/v0.15.0/pythinker-code-0.15.0.aarch64.rpm.sha256
+sha256sum -c pythinker-code-0.15.0.aarch64.rpm.sha256
+sudo dnf install ./pythinker-code-0.15.0.aarch64.rpm
+```
+
+Both packages drop a small `/usr/bin/pythinker` launcher that execs the real
+binary under `/usr/lib/pythinker/`, so your `$PATH` stays tidy.
+
+**Verify before install:**
 
 ```sh
-# Debian / Ubuntu
-sudo dpkg -i pythinker-code_x.y.z_amd64.deb
-# If apt complains about missing deps:
-sudo apt-get install -f
+sha256sum -c pythinker-code_0.15.0_amd64.deb.sha256        # Debian/Ubuntu
+sha256sum -c pythinker-code-0.15.0.x86_64.rpm.sha256       # Fedora/RHEL
+```
+
+**Upgrade:** download the new `.deb`/`.rpm` from Releases and `dpkg -i` /
+`dnf install` over it. Or run `pythinker update` from inside the running
+app — it'll fetch the matching new package and prompt for sudo to install.
+
+**Uninstall:**
 
-# Fedora / RHEL / openSUSE
-sudo rpm -i pythinker-code-x.y.z.x86_64.rpm
-# or:
-sudo dnf install ./pythinker-code-x.y.z.x86_64.rpm
+```sh
+sudo dpkg -r pythinker-code                                # Debian/Ubuntu
+sudo rpm -e pythinker-code                                 # Fedora/RHEL
 ```
 
-Both packages drop `/usr/bin/pythinker` (a small launcher that execs the real
-binary under `/usr/lib/pythinker/`).
+---
 
 ### 🌐 macOS / Linux — curl-bash native installer
 
-For machines without a package manager (containers, fresh VMs), the
-[install-native.sh](./scripts/install-native.sh) helper downloads the right
-tarball for your OS + arch, verifies SHA-256, and installs to `~/.local/`.
+For containers, fresh VMs, or any host without a system package manager.
+The canonical `https://pythinker.com/install.sh` endpoint is backed by
+[`scripts/install-native.sh`](./scripts/install-native.sh). It serves shell
+script content directly, detects your OS + arch, downloads the matching
+PyInstaller-frozen tarball, verifies its SHA-256, and lands the single binary
+at `~/.local/bin/pythinker`.
 
 ```sh
-curl -fsSL https://raw.githubusercontent.com/mohamed-elkholy95/Pythinker-Code/main/scripts/install-native.sh | bash
+# Latest release
+curl -fsSL https://pythinker.com/install.sh | bash
 
-# Pin a specific version:
-curl -fsSL ...install-native.sh | bash -s -- --version 0.13.0
+# Pin a specific version
+curl -fsSL https://pythinker.com/install.sh | bash -s -- --version 0.15.0
+
+# Custom prefix (defaults to $HOME/.local)
+curl -fsSL https://pythinker.com/install.sh | bash -s -- --prefix /opt/pythinker
 ```
 
-The script lands the binary at `~/.local/share/pythinker/` and symlinks
-`~/.local/bin/pythinker`. It prints PATH guidance if `~/.local/bin` isn't on
-your `$PATH`.
+Host `/install.sh` with:
+
+```http
+Content-Type: text/x-shellscript; charset=utf-8
+Cache-Control: public, max-age=300, s-maxage=900, stale-if-error=86400
+```
+
+Use long immutable caching only for versioned release artifact URLs, for
+example `Cache-Control: public, max-age=31536000, immutable` on fixed-tag
+assets.
+
+Supported targets:
+
+| `uname -s / -m`             | Tarball asset                                            |
+|---|---|
+| Linux / x86_64              | `pythinker-0.15.0-x86_64-unknown-linux-gnu.tar.gz`        |
+| Linux / aarch64             | `pythinker-0.15.0-aarch64-unknown-linux-gnu.tar.gz`       |
+| Darwin / arm64              | `pythinker-0.15.0-aarch64-apple-darwin.tar.gz`            |
+
+The script prints PATH guidance if `~/.local/bin` isn't already on your
+`$PATH`. Intel macOS users — use Homebrew or `pip install pythinker-code`;
+no PyInstaller-built Intel Darwin binary is published.
+
+**Uninstall:** `rm ~/.local/bin/pythinker`.
 
 ### 🛠 Power-user / legacy install paths
 
@@ -248,13 +342,10 @@ your `$PATH`.
 <summary>Legacy shell-script wrappers + uv / pipx</summary>
 
 ```sh
-# Legacy: uv-based shell-script wrappers (prints a deprecation banner on run)
-curl -fsSL https://raw.githubusercontent.com/mohamed-elkholy95/Pythinker-Code/main/scripts/install.sh | bash
-# Windows PowerShell wrapper:
-$installer = Join-Path $env:TEMP "pythinker-install.ps1"
-iwr -UseBasicParsing https://raw.githubusercontent.com/mohamed-elkholy95/Pythinker-Code/main/scripts/install.ps1 -OutFile $installer
-& $installer
-Remove-Item $installer
+# Compatibility shim to the native installer
+scripts/install.sh
+# Windows PowerShell native installer bootstrap:
+powershell -c "irm https://pythinker.com/install.ps1 | iex"
 
 # Legacy: one-off run via uvx
 uvx pythinker-code