pythinker-code 0.12.0__tar.gz → 0.14.0__tar.gz

{pythinker_code-0.12.0 → pythinker_code-0.14.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pythinker-code
-Version: 0.12.0
+Version: 0.14.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,14 +116,14 @@ It speaks the [**Agent Client Protocol (ACP)**](https://github.com/agentclientpr
 
 ---
 
-## 🆕 What's New in 0.12.0
+## 🆕 What's New in 0.14.0
 
-- **Native Windows installer.** A `PythinkerSetup-0.12.0.exe` is now attached to every GitHub Release. One double-click installs Pythinker per-user with no UAC prompt, no Python / Node / uv prerequisite, and registers `pythinker` on your PATH automatically. Uninstall via Apps & Features reverses every change. See the new *Windows — native installer* section in Quick Start for details.
-- **In-app updates for the native build.** `pythinker update` from inside the native installer detects the build, fetches the latest installer from GitHub Releases, verifies its SHA-256, and re-runs it silently. The existing `PYTHINKER_CLI_NO_AUTO_UPDATE` env var now gates both the PyPI and native update flows — one opt-out, both paths.
-- **Tag-triggered Windows CI.** A new `.github/workflows/windows-installer.yml` runs on every `pythinker-code-v*` tag, freezes `pythinker` via PyInstaller (`--onedir`), compiles the Inno Setup script, signs the result when the Authenticode cert is available, and uploads the `.exe` + SHA-256 to the Release.
-- **Shell terminal rhythm refinements.** Tone tokens, motion timing, and the sky-blue accent palette (`#7dd3fc` / `#93c5fd`) were retuned so transcript rows, motion status, and dialog surfaces breathe consistently. UI snapshot tests updated to lock the new rhythm in place.
+- **Install counts are now visible from the README.** The canonical `https://pythinker.com/install.sh` and `https://pythinker.com/install.ps1` endpoints are backed by a Cloudflare Worker that counts successful installer fetches and serves the flat-square install badge shown above.
+- **Safer, more reliable installer routing.** The hosted shell and PowerShell endpoints remain the canonical install paths, with fixed-version commands updated for `0.14.0` artifacts and SHA-256 verification across Windows, Linux, and macOS tarball installs.
+- **TUI activity polish.** Agent/task names now resolve at call time, live activity indicators use calmer grey headers and pinned spinner behavior, oversized output is capped, and markdown/tool surfaces are more consistent.
+- **Release and CI hardening.** Plugin downloads are stricter, the pythinker-home sync dispatch skips cleanly when its optional token is not configured, and the release docs reflect the current native installer flow.
 
-Upgrade with `pythinker update`, `pip install --upgrade pythinker-code==0.12.0`, or — on Windows — download `PythinkerSetup-0.12.0.exe` from the [Releases page](https://github.com/mohamed-elkholy95/Pythinker-Code/releases/latest).
+Upgrade with `pythinker update`, `pip install --upgrade pythinker-code==0.14.0`, or use the native installer for your platform from the [Releases page](https://github.com/mohamed-elkholy95/Pythinker-Code/releases/latest).
 
 
 ---
@@ -167,7 +168,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">
@@ -207,86 +208,224 @@ Swap providers and models per-session: `--model openai/gpt-5.5`, hosted Pythinke
 
 ## ⚡ Quick Start
 
-### 🪟 Windows — native installer (recommended)
-
-`PythinkerSetup-x.y.z.exe` is attached to every GitHub Release. It bundles
-Pythinker as a self-contained executable — **you do not need Python, Node, or
-uv installed**, and there is no UAC / admin prompt.
-
-**Install in three steps:**
-
-1. Download `PythinkerSetup-x.y.z.exe` and its `.sha256` companion from the
-   [latest Release](https://github.com/mohamed-elkholy95/Pythinker-Code/releases/latest).
-2. (Optional, recommended) Verify the SHA-256:
-   ```powershell
-   Get-FileHash .\PythinkerSetup-x.y.z.exe -Algorithm SHA256
-   Get-Content  .\PythinkerSetup-x.y.z.exe.sha256
-   ```
-   The hash from `Get-FileHash` must match the one in the `.sha256` file.
-3. Double-click the installer. It writes to `%LOCALAPPDATA%\Programs\Pythinker`,
-   registers `pythinker` on your user PATH (`HKCU\Environment`), and broadcasts
-   `WM_SETTINGCHANGE` so any new shell window picks it up.
-
-Open a fresh PowerShell and run `pythinker --version` to confirm.
-
-> 🛡 **First-launch SmartScreen warning** — until the Authenticode signing
-> cert is wired into the CI pipeline (see [build.ps1](./packages/windows-installer/build.ps1)
-> and the `WINDOWS_CERT_PFX_BASE64` / `WINDOWS_CERT_PASSWORD` secrets), the
-> installer ships unsigned and Windows SmartScreen will show *"Windows
-> protected your PC."* Click **More info → Run anyway**. The published
-> `.sha256` is your integrity check in the meantime.
-
-**Built-in auto-update:** running `pythinker update` from inside the native
-build queries the GitHub Releases API, downloads the newest installer,
-verifies its SHA-256, and re-runs it silently (`/VERYSILENT /SUPPRESSMSGBOXES
-/NORESTART`). Set `PYTHINKER_CLI_NO_AUTO_UPDATE=1` to disable the proactive
-update check on shell startup (this is the same opt-out the PyPI/uv install
-path uses — one knob, both flows).
-
-**Uninstall:** Apps & Features → *Pythinker Code* → Uninstall. The uninstaller
-removes the install directory and reverts the user-PATH edit. A new shell will
-no longer find `pythinker`.
-
-**Per-machine install** (multi-user / IT-managed boxes): pass `/ALLUSERS` to
-the installer from an admin console:
+Pythinker ships **native installers for every platform**. Pick the row that
+matches your OS — no Python, Node, or `uv` prerequisite.
+
+| Platform | One-line install | Artifact |
+|---|---|---|
+| **🪟 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_0.14.0_amd64.deb` | [Releases](https://github.com/mohamed-elkholy95/Pythinker-Code/releases/latest) |
+| **🐧 Linux (Fedora / RHEL)** | Download `pythinker-code-0.14.0.x86_64.rpm`, then `sudo dnf install ./pythinker-code-0.14.0.x86_64.rpm` | [Releases](https://github.com/mohamed-elkholy95/Pythinker-Code/releases/latest) |
+| **🐧 Linux (openSUSE)** | Download `pythinker-code-0.14.0.x86_64.rpm`, then `sudo zypper install ./pythinker-code-0.14.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 |
+
+Every artifact ships with a matching `.sha256` file — verify before install on
+any platform with `sha256sum`, `shasum -a 256`, or `Get-FileHash`.
+
+After install, on any OS:
+
+```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.
+
+---
+
+### 🪟 Windows — native installer
+
+`PythinkerSetup-0.14.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
-.\PythinkerSetup-x.y.z.exe /ALLUSERS
+# One-line install (downloads the native .exe, verifies SHA-256, runs per-user)
+irm https://pythinker.com/install.ps1 | iex
+
+# Or manually download the installer + checksum from the Releases page,
+# verify with Get-FileHash, then run:
+.\PythinkerSetup-0.14.0.exe
+
+# Open a fresh PowerShell
+pythinker --version
 ```
 
-This installs to `%ProgramFiles%\Pythinker` and registers PATH at the HKLM
-scope. The default (no flag) remains per-user.
+**Per-machine install** (IT-managed boxes): `.\PythinkerSetup-0.14.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`).
 
-### ✨ Recommended install (clean, with logo)
+**Uninstall:** Apps & Features → *Pythinker Code* → Uninstall reverts both
+the files and the PATH edit.
+
+> 🛡 **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 tap
 
 ```sh
-curl -fsSL https://raw.githubusercontent.com/mohamed-elkholy95/Pythinker-Code/main/scripts/install.sh | bash
+# 1. Install
+brew install mohamed-elkholy95/pythinker/pythinker-code
+
+# 2. Verify
+pythinker --version
+which pythinker          # -> /opt/homebrew/bin/pythinker (Apple Silicon)
+                         #    or /usr/local/bin/pythinker (Intel)
 ```
 
-Windows PowerShell:
+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.
 
-```powershell
-$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
+**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 `.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.14.0_amd64.deb
+sudo apt-get install -f       # only if dpkg reports missing deps
+
+# Debian / Ubuntu (ARM64)
+sudo dpkg -i pythinker-code_0.14.0_arm64.deb
+
+# Fedora / RHEL / openSUSE (x86_64)
+curl -LO https://github.com/mohamed-elkholy95/Pythinker-Code/releases/download/v0.14.0/pythinker-code-0.14.0.x86_64.rpm
+curl -LO https://github.com/mohamed-elkholy95/Pythinker-Code/releases/download/v0.14.0/pythinker-code-0.14.0.x86_64.rpm.sha256
+sha256sum -c pythinker-code-0.14.0.x86_64.rpm.sha256
+# Fedora / RHEL:
+sudo dnf install ./pythinker-code-0.14.0.x86_64.rpm
+# openSUSE:
+sudo zypper install ./pythinker-code-0.14.0.x86_64.rpm
+
+# Fedora / RHEL (aarch64)
+curl -LO https://github.com/mohamed-elkholy95/Pythinker-Code/releases/download/v0.14.0/pythinker-code-0.14.0.aarch64.rpm
+curl -LO https://github.com/mohamed-elkholy95/Pythinker-Code/releases/download/v0.14.0/pythinker-code-0.14.0.aarch64.rpm.sha256
+sha256sum -c pythinker-code-0.14.0.aarch64.rpm.sha256
+sudo dnf install ./pythinker-code-0.14.0.aarch64.rpm
 ```
 
-The installer fetches `uv` if missing, installs `pythinker-code` quietly, and prints a single-line confirmation instead of the full dependency wall. Windows downloads the script to a file (instead of `irm ... | iex`) so PowerShell antivirus scanning is less likely to block it, but it is invoked with `&` in the current session so PATH updates from `uv` are immediately visible — `pythinker` works without opening a new shell.
+Both packages drop a small `/usr/bin/pythinker` launcher that execs the real
+binary under `/usr/lib/pythinker/`, so your `$PATH` stays tidy.
 
-### 🚀 One-off run with `uvx`
+**Verify before install:**
 
 ```sh
-uvx pythinker-code
+sha256sum -c pythinker-code_0.14.0_amd64.deb.sha256        # Debian/Ubuntu
+sha256sum -c pythinker-code-0.14.0.x86_64.rpm.sha256       # Fedora/RHEL
 ```
 
-### 📦 Install as a uv tool
+**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:**
 
 ```sh
+sudo dpkg -r pythinker-code                                # Debian/Ubuntu
+sudo rpm -e pythinker-code                                 # Fedora/RHEL
+```
+
+---
+
+### 🌐 macOS / Linux — curl-bash native installer
+
+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
+# Latest release
+curl -fsSL https://pythinker.com/install.sh | bash
+
+# Pin a specific version
+curl -fsSL https://pythinker.com/install.sh | bash -s -- --version 0.14.0
+
+# Custom prefix (defaults to $HOME/.local)
+curl -fsSL https://pythinker.com/install.sh | bash -s -- --prefix /opt/pythinker
+```
+
+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.14.0-x86_64-unknown-linux-gnu.tar.gz`        |
+| Linux / aarch64             | `pythinker-0.14.0-aarch64-unknown-linux-gnu.tar.gz`       |
+| Darwin / arm64              | `pythinker-0.14.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
+
+> 🚧 **Deprecated.** These paths still work, but the per-OS native installers
+> above are the canonical install method for **all new releases**. The legacy
+> options below remain for existing automation; new tooling, examples, and
+> support docs target the native installers exclusively.
+
+<details>
+<summary>Legacy shell-script wrappers + uv / pipx</summary>
+
+```sh
+# 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
+
+# Legacy: install as a uv tool
 uv tool install pythinker-code
-pythinker
+
+# Legacy: PyPI directly (universal fallback)
+pip install pythinker-code
+pipx install pythinker-code
 ```
 
+</details>
+
 ### 🔐 Authenticate (optional)
 
 For hosted Pythinker models or ACP terminal auth: