PyPI - pythinker-code - Versions diffs - 0.16.0__tar.gz → 0.18.0__tar.gz - Mend

pythinker-code 0.16.0tar.gz → 0.18.0tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (841) hide show

{pythinker_code-0.16.0 → pythinker_code-0.18.0}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pythinker-code
-Version: 0.16.0
+Version: 0.18.0
 Summary: Pythinker Code is your next CLI agent.
 Keywords: cli,agent,ai,coding-assistant,llm,claude,openai,terminal
 Author: Mohamed Elkholy
@@ -80,7 +80,6 @@ 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/)
@@ -116,13 +115,15 @@ It speaks the [**Agent Client Protocol (ACP)**](https://github.com/agentclientpr
 ---
-## 🆕 What's New in 0.16.0
+## 🆕 What's New in 0.18.0
-- **Native installation is standardized across platforms.** Quick Start now leads with the canonical hosted installers: `irm https://pythinker.com/install.ps1 | iex` on Windows and `curl -fsSL https://pythinker.com/install.sh | bash` on macOS/Linux.
-- **Old local installer wrappers are removed from user-facing docs.** Legacy local shell wrappers and Python-tool manager shortcuts are no longer presented as install options; Python package installs remain documented only as the universal fallback.
-- **Release artifact links are consistent.** Manual `.exe`, `.deb`, `.rpm`, and tarball instructions all point at GitHub Release assets for `0.16.0` and include SHA-256 verification guidance.
+- **Live subagent activity streaming.** Subagent tool calls now stream live into the transcript, with safe pending headers for in-flight tool calls, new transcript progress events, and a unified shimmer animation across active-work labels so long-running exploration stays legible.
+- **Smarter delegation and orchestration.** A Context-First Orchestration Protocol guides the default agent, specialist subagents receive prompt packets for single-objective delegation plus evidence and verification gates, and overflow RunAgents children are deferred instead of hard-failing.
+- **Calmer, more resilient TUI.** In-flight and singular Ask payloads no longer flash an invalid badge, MCP startup status is cleaner, and shell rendering and MCP guidance are refined.
+- **Sturdier configuration handling.** Incompatible legacy JSON config is now preserved instead of being silently reset to defaults.
+- **Security and shell hardening.** The security scan and shell execution paths were hardened against unexpected input.
-Upgrade with `pythinker update`, `pip install --upgrade pythinker-code==0.16.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.18.0`, or use the native installer for your platform from the [Releases page](https://github.com/mohamed-elkholy95/Pythinker-Code/releases/latest).
 ---
@@ -212,10 +213,10 @@ matches your OS — no Python, Node, or `uv` prerequisite.
 | Platform | Recommended install | Artifact source |
 |---|---|---|
-| **🪟 Windows** | `irm https://pythinker.com/install.ps1 \| iex` | `PythinkerSetup-0.16.0.exe` from [Releases](https://github.com/mohamed-elkholy95/Pythinker-Code/releases/latest) |
-| **🍎 macOS / 🐧 Linux** | `curl -fsSL https://pythinker.com/install.sh \| bash` | native tarball from [Releases](https://github.com/mohamed-elkholy95/Pythinker-Code/releases/latest) |
-| **🍎 macOS — Homebrew** | `brew install mohamed-elkholy95/pythinker/pythinker-code` | auto-published Homebrew tap |
-| **🐧 Linux — system package** | Download the `.deb` or `.rpm` for your distro below | [Releases](https://github.com/mohamed-elkholy95/Pythinker-Code/releases/latest) |
+| **🪟 Windows** | `irm https://pythinker.com/install.ps1 \| iex` | `PythinkerSetup-0.18.0.exe` from [Releases](https://github.com/mohamed-elkholy95/Pythinker-Code/releases/latest) |
+| **<img src="https://img.shields.io/badge/-macOS-000000?style=flat-square&logo=apple&logoColor=white" alt="macOS"> / <img src="https://img.shields.io/badge/-Linux-FCC624?style=flat-square&logo=linux&logoColor=black" alt="Linux">** | `curl -fsSL https://pythinker.com/install.sh \| bash` | native tarball from [Releases](https://github.com/mohamed-elkholy95/Pythinker-Code/releases/latest) |
+| **<img src="https://img.shields.io/badge/-macOS-000000?style=flat-square&logo=apple&logoColor=white" alt="macOS"> — Homebrew** | `brew install mohamed-elkholy95/pythinker/pythinker-code` | auto-published Homebrew tap |
+| **<img src="https://img.shields.io/badge/-Linux-FCC624?style=flat-square&logo=linux&logoColor=black" alt="Linux"> — system package** | Download the `.deb` or `.rpm` for your distro below | [Releases](https://github.com/mohamed-elkholy95/Pythinker-Code/releases/latest) |
 | **🐍 Python fallback** | `pip install pythinker-code` | PyPI |
 Every artifact ships with a matching `.sha256` file — verify before install on
@@ -237,7 +238,7 @@ pythinker                      # start the interactive TUI
 ### 🪟 Windows — native installer
-`PythinkerSetup-0.16.0.exe` is a signed* Inno Setup wizard. Installs per-user
+`PythinkerSetup-0.18.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.**
@@ -248,13 +249,13 @@ 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.16.0.exe
+.\PythinkerSetup-0.18.0.exe
 # Open a fresh PowerShell
 pythinker --version
 ```
-**Per-machine install** (IT-managed boxes): `.\PythinkerSetup-0.16.0.exe /ALLUSERS`
+**Per-machine install** (IT-managed boxes): `.\PythinkerSetup-0.18.0.exe /ALLUSERS`
 installs to `%ProgramFiles%\Pythinker` and writes PATH to HKLM (requires admin).
 **Upgrade:** `pythinker update` from inside the running app — it downloads
@@ -271,7 +272,7 @@ the files and the PATH edit.
 ---
-### 🍎 macOS — Homebrew tap
+### <img src="https://img.shields.io/badge/-macOS-000000?style=flat-square&logo=apple&logoColor=white" alt="macOS"> — Homebrew tap
 ```sh
 # 1. Install
@@ -297,33 +298,33 @@ auto-update; run this whenever you want the latest).
 ---
-### 🐧 Linux — system packages
+### <img src="https://img.shields.io/badge/-Linux-FCC624?style=flat-square&logo=linux&logoColor=black" alt="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.16.0_amd64.deb
+sudo dpkg -i pythinker-code_0.18.0_amd64.deb
 sudo apt-get install -f       # only if dpkg reports missing deps
 # Debian / Ubuntu (ARM64)
-sudo dpkg -i pythinker-code_0.16.0_arm64.deb
+sudo dpkg -i pythinker-code_0.18.0_arm64.deb
 # Fedora / RHEL / openSUSE (x86_64)
-curl -LO https://github.com/mohamed-elkholy95/Pythinker-Code/releases/download/v0.16.0/pythinker-code-0.16.0.x86_64.rpm
-curl -LO https://github.com/mohamed-elkholy95/Pythinker-Code/releases/download/v0.16.0/pythinker-code-0.16.0.x86_64.rpm.sha256
-sha256sum -c pythinker-code-0.16.0.x86_64.rpm.sha256
+curl -LO https://github.com/mohamed-elkholy95/Pythinker-Code/releases/download/v0.18.0/pythinker-code-0.18.0.x86_64.rpm
+curl -LO https://github.com/mohamed-elkholy95/Pythinker-Code/releases/download/v0.18.0/pythinker-code-0.18.0.x86_64.rpm.sha256
+sha256sum -c pythinker-code-0.18.0.x86_64.rpm.sha256
 # Fedora / RHEL:
-sudo dnf install ./pythinker-code-0.16.0.x86_64.rpm
+sudo dnf install ./pythinker-code-0.18.0.x86_64.rpm
 # openSUSE:
-sudo zypper install ./pythinker-code-0.16.0.x86_64.rpm
+sudo zypper install ./pythinker-code-0.18.0.x86_64.rpm
 # Fedora / RHEL (aarch64)
-curl -LO https://github.com/mohamed-elkholy95/Pythinker-Code/releases/download/v0.16.0/pythinker-code-0.16.0.aarch64.rpm
-curl -LO https://github.com/mohamed-elkholy95/Pythinker-Code/releases/download/v0.16.0/pythinker-code-0.16.0.aarch64.rpm.sha256
-sha256sum -c pythinker-code-0.16.0.aarch64.rpm.sha256
-sudo dnf install ./pythinker-code-0.16.0.aarch64.rpm
+curl -LO https://github.com/mohamed-elkholy95/Pythinker-Code/releases/download/v0.18.0/pythinker-code-0.18.0.aarch64.rpm
+curl -LO https://github.com/mohamed-elkholy95/Pythinker-Code/releases/download/v0.18.0/pythinker-code-0.18.0.aarch64.rpm.sha256
+sha256sum -c pythinker-code-0.18.0.aarch64.rpm.sha256
+sudo dnf install ./pythinker-code-0.18.0.aarch64.rpm
 ```
 Both packages drop a small `/usr/bin/pythinker` launcher that execs the real
@@ -332,8 +333,8 @@ binary under `/usr/lib/pythinker/`, so your `$PATH` stays tidy.
 **Verify before install:**
 ```sh
-sha256sum -c pythinker-code_0.16.0_amd64.deb.sha256        # Debian/Ubuntu
-sha256sum -c pythinker-code-0.16.0.x86_64.rpm.sha256       # Fedora/RHEL
+sha256sum -c pythinker-code_0.18.0_amd64.deb.sha256        # Debian/Ubuntu
+sha256sum -c pythinker-code-0.18.0.x86_64.rpm.sha256       # Fedora/RHEL
 ```
 **Upgrade:** download the new `.deb`/`.rpm` from Releases and `dpkg -i` /
@@ -349,7 +350,7 @@ sudo rpm -e pythinker-code                                 # Fedora/RHEL
 ---
-### 🌐 macOS / Linux — curl-bash native installer
+### <img src="https://img.shields.io/badge/-macOS-000000?style=flat-square&logo=apple&logoColor=white" alt="macOS"> / <img src="https://img.shields.io/badge/-Linux-FCC624?style=flat-square&logo=linux&logoColor=black" alt="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
@@ -363,7 +364,7 @@ at `~/.local/bin/pythinker`.
 curl -fsSL https://pythinker.com/install.sh | bash
 # Pin a specific version
-curl -fsSL https://pythinker.com/install.sh | bash -s -- --version 0.16.0
+curl -fsSL https://pythinker.com/install.sh | bash -s -- --version 0.18.0
 # Custom prefix (defaults to $HOME/.local)
 curl -fsSL https://pythinker.com/install.sh | bash -s -- --prefix /opt/pythinker
@@ -384,9 +385,9 @@ Supported targets:
 | `uname -s / -m`             | Tarball asset                                            |
 |---|---|
-| Linux / x86_64              | `pythinker-0.16.0-x86_64-unknown-linux-gnu.tar.gz`        |
-| Linux / aarch64             | `pythinker-0.16.0-aarch64-unknown-linux-gnu.tar.gz`       |
-| Darwin / arm64              | `pythinker-0.16.0-aarch64-apple-darwin.tar.gz`            |
+| Linux / x86_64              | `pythinker-0.18.0-x86_64-unknown-linux-gnu.tar.gz`        |
+| Linux / aarch64             | `pythinker-0.18.0-aarch64-unknown-linux-gnu.tar.gz`       |
+| Darwin / arm64              | `pythinker-0.18.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`;
@@ -616,14 +617,18 @@ Pythinker loads [Model Context Protocol](https://modelcontextprotocol.io/) tools
 ### 🛠️ Manage persistent MCP servers
 ```sh
+# 📚 Context7 stdio server (Codex-style: NAME -- COMMAND)
+pythinker mcp add context7 -- npx -y @upstash/context7-mcp --api-key YOUR-API-KEY
+# Added MCP server 'context7' to ~/.pythinker/mcp.json
 # 🌐 Streamable HTTP server with API key
-pythinker mcp add --transport http context7 https://mcp.context7.com/mcp \
-  --header "CONTEXT7_API_KEY: ctx7sk-your-key"
+pythinker mcp add --transport http docs https://example.com/mcp \
+  --header "API_KEY: your-key"
 # 🔐 Streamable HTTP server with OAuth
 pythinker mcp add --transport http --auth oauth linear https://mcp.linear.app/mcp
-# 💻 stdio server
+# 💻 stdio server with explicit transport
 pythinker mcp add --transport stdio chrome-devtools -- npx chrome-devtools-mcp@latest
 # 📋 List, authorize, test, and remove
@@ -713,16 +718,9 @@ file paths, or any user-identifying data. Two channels:
 - Your real name, email, IP address, hostname (host name field is dropped at the edge collector)
 - Tool arguments (e.g. what file you read, what command you ran)
-### Opting in or forcing off
-Telemetry is off by default. To enable it for a process:
-```sh
-export PYTHINKER_ENABLE_TELEMETRY=1
-pythinker
-```
+### Turning it off
-To force telemetry off even if another setting enabled it:
+Telemetry is on by default. To turn it off:
 ```sh
 # 1. Per-invocation CLI flag
@@ -752,8 +750,8 @@ export PYTHINKER_OTEL_ENDPOINT="https://your-otel-collector.example.com"
 export PYTHINKER_OTEL_TOKEN="<your bearer token>"
 ```
-The defaults point at infrastructure operated by the pythinker maintainers;
-set `PYTHINKER_ENABLE_TELEMETRY=1` to use them.
+The defaults point at infrastructure operated by the pythinker maintainers and
+are used automatically unless you turn telemetry off.
 ---

{pythinker_code-0.16.0 → pythinker_code-0.18.0}/README.md RENAMED Viewed

@@ -15,7 +15,6 @@
 [![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/)
@@ -51,13 +50,15 @@ It speaks the [**Agent Client Protocol (ACP)**](https://github.com/agentclientpr
 ---
-## 🆕 What's New in 0.16.0
+## 🆕 What's New in 0.18.0
-- **Native installation is standardized across platforms.** Quick Start now leads with the canonical hosted installers: `irm https://pythinker.com/install.ps1 | iex` on Windows and `curl -fsSL https://pythinker.com/install.sh | bash` on macOS/Linux.
-- **Old local installer wrappers are removed from user-facing docs.** Legacy local shell wrappers and Python-tool manager shortcuts are no longer presented as install options; Python package installs remain documented only as the universal fallback.
-- **Release artifact links are consistent.** Manual `.exe`, `.deb`, `.rpm`, and tarball instructions all point at GitHub Release assets for `0.16.0` and include SHA-256 verification guidance.
+- **Live subagent activity streaming.** Subagent tool calls now stream live into the transcript, with safe pending headers for in-flight tool calls, new transcript progress events, and a unified shimmer animation across active-work labels so long-running exploration stays legible.
+- **Smarter delegation and orchestration.** A Context-First Orchestration Protocol guides the default agent, specialist subagents receive prompt packets for single-objective delegation plus evidence and verification gates, and overflow RunAgents children are deferred instead of hard-failing.
+- **Calmer, more resilient TUI.** In-flight and singular Ask payloads no longer flash an invalid badge, MCP startup status is cleaner, and shell rendering and MCP guidance are refined.
+- **Sturdier configuration handling.** Incompatible legacy JSON config is now preserved instead of being silently reset to defaults.
+- **Security and shell hardening.** The security scan and shell execution paths were hardened against unexpected input.
-Upgrade with `pythinker update`, `pip install --upgrade pythinker-code==0.16.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.18.0`, or use the native installer for your platform from the [Releases page](https://github.com/mohamed-elkholy95/Pythinker-Code/releases/latest).
 ---
@@ -147,10 +148,10 @@ matches your OS — no Python, Node, or `uv` prerequisite.
 | Platform | Recommended install | Artifact source |
 |---|---|---|
-| **🪟 Windows** | `irm https://pythinker.com/install.ps1 \| iex` | `PythinkerSetup-0.16.0.exe` from [Releases](https://github.com/mohamed-elkholy95/Pythinker-Code/releases/latest) |
-| **🍎 macOS / 🐧 Linux** | `curl -fsSL https://pythinker.com/install.sh \| bash` | native tarball from [Releases](https://github.com/mohamed-elkholy95/Pythinker-Code/releases/latest) |
-| **🍎 macOS — Homebrew** | `brew install mohamed-elkholy95/pythinker/pythinker-code` | auto-published Homebrew tap |
-| **🐧 Linux — system package** | Download the `.deb` or `.rpm` for your distro below | [Releases](https://github.com/mohamed-elkholy95/Pythinker-Code/releases/latest) |
+| **🪟 Windows** | `irm https://pythinker.com/install.ps1 \| iex` | `PythinkerSetup-0.18.0.exe` from [Releases](https://github.com/mohamed-elkholy95/Pythinker-Code/releases/latest) |
+| **<img src="https://img.shields.io/badge/-macOS-000000?style=flat-square&logo=apple&logoColor=white" alt="macOS"> / <img src="https://img.shields.io/badge/-Linux-FCC624?style=flat-square&logo=linux&logoColor=black" alt="Linux">** | `curl -fsSL https://pythinker.com/install.sh \| bash` | native tarball from [Releases](https://github.com/mohamed-elkholy95/Pythinker-Code/releases/latest) |
+| **<img src="https://img.shields.io/badge/-macOS-000000?style=flat-square&logo=apple&logoColor=white" alt="macOS"> — Homebrew** | `brew install mohamed-elkholy95/pythinker/pythinker-code` | auto-published Homebrew tap |
+| **<img src="https://img.shields.io/badge/-Linux-FCC624?style=flat-square&logo=linux&logoColor=black" alt="Linux"> — system package** | Download the `.deb` or `.rpm` for your distro below | [Releases](https://github.com/mohamed-elkholy95/Pythinker-Code/releases/latest) |
 | **🐍 Python fallback** | `pip install pythinker-code` | PyPI |
 Every artifact ships with a matching `.sha256` file — verify before install on
@@ -172,7 +173,7 @@ pythinker                      # start the interactive TUI
 ### 🪟 Windows — native installer
-`PythinkerSetup-0.16.0.exe` is a signed* Inno Setup wizard. Installs per-user
+`PythinkerSetup-0.18.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.**
@@ -183,13 +184,13 @@ 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.16.0.exe
+.\PythinkerSetup-0.18.0.exe
 # Open a fresh PowerShell
 pythinker --version
 ```
-**Per-machine install** (IT-managed boxes): `.\PythinkerSetup-0.16.0.exe /ALLUSERS`
+**Per-machine install** (IT-managed boxes): `.\PythinkerSetup-0.18.0.exe /ALLUSERS`
 installs to `%ProgramFiles%\Pythinker` and writes PATH to HKLM (requires admin).
 **Upgrade:** `pythinker update` from inside the running app — it downloads
@@ -206,7 +207,7 @@ the files and the PATH edit.
 ---
-### 🍎 macOS — Homebrew tap
+### <img src="https://img.shields.io/badge/-macOS-000000?style=flat-square&logo=apple&logoColor=white" alt="macOS"> — Homebrew tap
 ```sh
 # 1. Install
@@ -232,33 +233,33 @@ auto-update; run this whenever you want the latest).
 ---
-### 🐧 Linux — system packages
+### <img src="https://img.shields.io/badge/-Linux-FCC624?style=flat-square&logo=linux&logoColor=black" alt="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.16.0_amd64.deb
+sudo dpkg -i pythinker-code_0.18.0_amd64.deb
 sudo apt-get install -f       # only if dpkg reports missing deps
 # Debian / Ubuntu (ARM64)
-sudo dpkg -i pythinker-code_0.16.0_arm64.deb
+sudo dpkg -i pythinker-code_0.18.0_arm64.deb
 # Fedora / RHEL / openSUSE (x86_64)
-curl -LO https://github.com/mohamed-elkholy95/Pythinker-Code/releases/download/v0.16.0/pythinker-code-0.16.0.x86_64.rpm
-curl -LO https://github.com/mohamed-elkholy95/Pythinker-Code/releases/download/v0.16.0/pythinker-code-0.16.0.x86_64.rpm.sha256
-sha256sum -c pythinker-code-0.16.0.x86_64.rpm.sha256
+curl -LO https://github.com/mohamed-elkholy95/Pythinker-Code/releases/download/v0.18.0/pythinker-code-0.18.0.x86_64.rpm
+curl -LO https://github.com/mohamed-elkholy95/Pythinker-Code/releases/download/v0.18.0/pythinker-code-0.18.0.x86_64.rpm.sha256
+sha256sum -c pythinker-code-0.18.0.x86_64.rpm.sha256
 # Fedora / RHEL:
-sudo dnf install ./pythinker-code-0.16.0.x86_64.rpm
+sudo dnf install ./pythinker-code-0.18.0.x86_64.rpm
 # openSUSE:
-sudo zypper install ./pythinker-code-0.16.0.x86_64.rpm
+sudo zypper install ./pythinker-code-0.18.0.x86_64.rpm
 # Fedora / RHEL (aarch64)
-curl -LO https://github.com/mohamed-elkholy95/Pythinker-Code/releases/download/v0.16.0/pythinker-code-0.16.0.aarch64.rpm
-curl -LO https://github.com/mohamed-elkholy95/Pythinker-Code/releases/download/v0.16.0/pythinker-code-0.16.0.aarch64.rpm.sha256
-sha256sum -c pythinker-code-0.16.0.aarch64.rpm.sha256
-sudo dnf install ./pythinker-code-0.16.0.aarch64.rpm
+curl -LO https://github.com/mohamed-elkholy95/Pythinker-Code/releases/download/v0.18.0/pythinker-code-0.18.0.aarch64.rpm
+curl -LO https://github.com/mohamed-elkholy95/Pythinker-Code/releases/download/v0.18.0/pythinker-code-0.18.0.aarch64.rpm.sha256
+sha256sum -c pythinker-code-0.18.0.aarch64.rpm.sha256
+sudo dnf install ./pythinker-code-0.18.0.aarch64.rpm
 ```
 Both packages drop a small `/usr/bin/pythinker` launcher that execs the real
@@ -267,8 +268,8 @@ binary under `/usr/lib/pythinker/`, so your `$PATH` stays tidy.
 **Verify before install:**
 ```sh
-sha256sum -c pythinker-code_0.16.0_amd64.deb.sha256        # Debian/Ubuntu
-sha256sum -c pythinker-code-0.16.0.x86_64.rpm.sha256       # Fedora/RHEL
+sha256sum -c pythinker-code_0.18.0_amd64.deb.sha256        # Debian/Ubuntu
+sha256sum -c pythinker-code-0.18.0.x86_64.rpm.sha256       # Fedora/RHEL
 ```
 **Upgrade:** download the new `.deb`/`.rpm` from Releases and `dpkg -i` /
@@ -284,7 +285,7 @@ sudo rpm -e pythinker-code                                 # Fedora/RHEL
 ---
-### 🌐 macOS / Linux — curl-bash native installer
+### <img src="https://img.shields.io/badge/-macOS-000000?style=flat-square&logo=apple&logoColor=white" alt="macOS"> / <img src="https://img.shields.io/badge/-Linux-FCC624?style=flat-square&logo=linux&logoColor=black" alt="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
@@ -298,7 +299,7 @@ at `~/.local/bin/pythinker`.
 curl -fsSL https://pythinker.com/install.sh | bash
 # Pin a specific version
-curl -fsSL https://pythinker.com/install.sh | bash -s -- --version 0.16.0
+curl -fsSL https://pythinker.com/install.sh | bash -s -- --version 0.18.0
 # Custom prefix (defaults to $HOME/.local)
 curl -fsSL https://pythinker.com/install.sh | bash -s -- --prefix /opt/pythinker
@@ -319,9 +320,9 @@ Supported targets:
 | `uname -s / -m`             | Tarball asset                                            |
 |---|---|
-| Linux / x86_64              | `pythinker-0.16.0-x86_64-unknown-linux-gnu.tar.gz`        |
-| Linux / aarch64             | `pythinker-0.16.0-aarch64-unknown-linux-gnu.tar.gz`       |
-| Darwin / arm64              | `pythinker-0.16.0-aarch64-apple-darwin.tar.gz`            |
+| Linux / x86_64              | `pythinker-0.18.0-x86_64-unknown-linux-gnu.tar.gz`        |
+| Linux / aarch64             | `pythinker-0.18.0-aarch64-unknown-linux-gnu.tar.gz`       |
+| Darwin / arm64              | `pythinker-0.18.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`;
@@ -551,14 +552,18 @@ Pythinker loads [Model Context Protocol](https://modelcontextprotocol.io/) tools
 ### 🛠️ Manage persistent MCP servers
 ```sh
+# 📚 Context7 stdio server (Codex-style: NAME -- COMMAND)
+pythinker mcp add context7 -- npx -y @upstash/context7-mcp --api-key YOUR-API-KEY
+# Added MCP server 'context7' to ~/.pythinker/mcp.json
 # 🌐 Streamable HTTP server with API key
-pythinker mcp add --transport http context7 https://mcp.context7.com/mcp \
-  --header "CONTEXT7_API_KEY: ctx7sk-your-key"
+pythinker mcp add --transport http docs https://example.com/mcp \
+  --header "API_KEY: your-key"
 # 🔐 Streamable HTTP server with OAuth
 pythinker mcp add --transport http --auth oauth linear https://mcp.linear.app/mcp
-# 💻 stdio server
+# 💻 stdio server with explicit transport
 pythinker mcp add --transport stdio chrome-devtools -- npx chrome-devtools-mcp@latest
 # 📋 List, authorize, test, and remove
@@ -648,16 +653,9 @@ file paths, or any user-identifying data. Two channels:
 - Your real name, email, IP address, hostname (host name field is dropped at the edge collector)
 - Tool arguments (e.g. what file you read, what command you ran)
-### Opting in or forcing off
-Telemetry is off by default. To enable it for a process:
-```sh
-export PYTHINKER_ENABLE_TELEMETRY=1
-pythinker
-```
+### Turning it off
-To force telemetry off even if another setting enabled it:
+Telemetry is on by default. To turn it off:
 ```sh
 # 1. Per-invocation CLI flag
@@ -687,8 +685,8 @@ export PYTHINKER_OTEL_ENDPOINT="https://your-otel-collector.example.com"
 export PYTHINKER_OTEL_TOKEN="<your bearer token>"
 ```
-The defaults point at infrastructure operated by the pythinker maintainers;
-set `PYTHINKER_ENABLE_TELEMETRY=1` to use them.
+The defaults point at infrastructure operated by the pythinker maintainers and
+are used automatically unless you turn telemetry off.
 ---

{pythinker_code-0.16.0 → pythinker_code-0.18.0}/pyproject.toml RENAMED Viewed

@@ -1,6 +1,6 @@
 [project]
 name = "pythinker-code"
-version = "0.16.0"
+version = "0.18.0"
 description = "Pythinker Code is your next CLI agent."
 readme = "README.md"
 requires-python = ">=3.12"

{pythinker_code-0.16.0 → pythinker_code-0.18.0}/src/pythinker_code/CHANGELOG.md RENAMED Viewed

@@ -15,6 +15,30 @@ GitHub Releases page; `0.8.0` is the new starting line.
 ## Unreleased
+## 0.18.0 (2026-05-27)
+### What changed in this release
+- **Live subagent activity streaming.** Subagent tool calls now stream live into the transcript, with safe pending headers for in-flight tool calls, new transcript progress events, and a unified shimmer animation across active-work labels so long-running exploration stays legible.
+- **Smarter delegation and orchestration.** A Context-First Orchestration Protocol guides the default agent, specialist subagents receive prompt packets for single-objective delegation plus evidence and verification gates, and overflow RunAgents children are deferred instead of hard-failing.
+- **Calmer, more resilient TUI.** In-flight and singular Ask payloads no longer flash an invalid badge, MCP startup status is cleaner, and shell rendering and MCP guidance are refined.
+- **Sturdier configuration handling.** Incompatible legacy JSON config is now preserved instead of being silently reset to defaults.
+- **Security and shell hardening.** The security scan and shell execution paths were hardened against unexpected input.
+Upgrade with `pythinker update`, `pip install --upgrade pythinker-code==0.18.0`, or use the native installer for your OS (see the README install table).
+## 0.17.0 (2026-05-25)
+### What changed in this release
+- **Sharper compaction continuity.** PreCompact now carries custom instructions, restores skill and hook context after compaction, triggers SessionStart after restore, and preserves the `Conversation compacted.` handoff so long sessions resume cleanly.
+- **Better subagent orchestration.** Subagent specs merge inherited subagent maps, foreground and background launches preserve parent-agent IDs for spawn-tree tracking, RunAgents fingerprints include agent names, and markdown agent discovery warns on unknown models instead of silently falling back.
+- **Polished terminal workflow.** The shell adopts the robot-brand palette, compact transcript/agent/file-mention menus, pinned live todo activity, calmer tool output, safer auto-backgrounding for long shell commands, and updated render snapshots.
+- **Release and installer hardening.** Interactive sessions show a blocking pre-start update prompt, update exits wait for acknowledgement, Homebrew publish retries package installs, and native installers gain a friendlier animated path with Windows User PATH automation.
+- **Provider compatibility refresh.** Anthropic SDK support is updated for 0.101 tool-result block types so direct Anthropic sessions continue to stream tool output correctly.
+Upgrade with `pythinker update`, `pip install --upgrade pythinker-code==0.17.0`, or use the native installer for your OS (see the README install table).
 ## 0.16.0 (2026-05-24)
 ### What changed in this release

{pythinker_code-0.16.0 → pythinker_code-0.18.0}/src/pythinker_code/agents/default/code_reviewer.yaml RENAMED Viewed

@@ -20,8 +20,9 @@ agent:
       Review discipline:
       - If `.pythinker/review-guidelines.md` exists, read it before scoring findings.
+      - Build a review context packet: base ref/diff scope, changed behavior, likely tests, user-visible impact, and validation evidence.
       - Flag only issues introduced or made reachable by the diff.
-      - Prefer no finding over vague speculation.
+      - Prefer no finding over vague speculation. Every finding must cite concrete evidence and a failure mode.
       - Do not request tests unless they cover a distinct behavior or risk introduced by the change.
       - Treat V0 robustness suggestions as future work unless they risk correctness, security, data loss, or persistent hangs.
       - For user-visible UI/behavior changes, check whether screenshots, GIFs, videos, or equivalent visual evidence are present; if absent, request that evidence as a blocking review concern.

{pythinker_code-0.16.0 → pythinker_code-0.18.0}/src/pythinker_code/agents/default/coder.yaml RENAMED Viewed

@@ -7,13 +7,23 @@ agent:
       Stay tightly scoped to exactly what the parent assigned. Do not expand into adjacent cleanup or refactors. If you discover related work, surface it under RISKS or BLOCKERS rather than doing it.
-      Before editing, read the target files and confirm the line ranges/patterns you will change. Prefer the minimum edit that satisfies the brief. After edits, run the smallest relevant verification command available and report the result.
+      Context gate before editing:
+      - Confirm the parent provided a clear goal, scope, constraints, and acceptance criteria. If not, inspect the code enough to infer them or report BLOCKERS.
+      - Read target files, nearby patterns, and relevant tests before writing. Do not edit code you cannot explain.
+      - Prefer the minimum implementation that satisfies the brief; no speculative abstractions or broad formatting churn.
+      Implementation method:
+      - Before editing, read the target files and confirm the line ranges/patterns you will change.
+      - Prefer StrReplaceFile for narrow changes; use WriteFile only for new files or intentional full rewrites.
+      - Add or update tests when the brief requires behavior changes and the project has relevant tests.
+      - After edits, inspect the diff/changed files for scope creep, TODOs/placeholders, import mistakes, and logic mismatches.
+      - Run the smallest relevant verification command available and report the result. If verification cannot run, explain the blocker.
       Final response contract:
       ### SUMMARY
       One paragraph with what you did and the outcome.
       ### EVIDENCE
-      Bullet list of concrete file paths, command results, or observed errors that support the outcome.
+      Bullet list of concrete file paths, command results, diff inspection, or observed errors that support the outcome.
       ### CHANGES
       Bullet list of every file you modified, or `None.` if read-only.
       ### RISKS

{pythinker_code-0.16.0 → pythinker_code-0.18.0}/src/pythinker_code/agents/default/debugger.yaml RENAMED Viewed

@@ -5,24 +5,31 @@ agent:
     ROLE_ADDITIONAL: |
       You are now running as a subagent. All `user` messages are sent by the main agent. The main agent cannot see your context, only your last message. Treat the parent agent as your caller. Do not ask the end user questions; surface ambiguity in your final summary.
-      You are a root-cause debugger. Your job is to run `pythinker debug failure <log-file>` when a failure log is available, or request the parent provide the log path/command evidence.
+      You are a root-cause debugger. Your job is to establish reproduction evidence, isolate the likely cause, and recommend the smallest next action before anyone edits code.
+      Reproduction protocol:
+      - If a failure log is available, run `pythinker debug failure <log-file> --format json` and translate the result for the parent.
+      - If no log file is available but a failing command is provided, run the command only when it is safe and bounded; capture stdout/stderr and exit code.
+      - If neither log nor command evidence is available, do not guess. Request the parent provide the missing log path, failing command, environment, or reproduction steps under BLOCKERS.
       Operating rules:
       - If `.pythinker/review-guidelines.md` exists, read it before judging failure severity or fix priority.
       - Read-only by convention. Do not edit source files.
-      - Focus on reproduction evidence, changed-file correlation, likely root cause, and minimal next action.
+      - Observe first: stack traces, assertions, recent diffs, environment, and reproduction steps.
+      - Correlate failures with changed files, callers/callees, config, tests, and recent assumptions.
+      - State confidence. Separate confirmed root cause from plausible hypotheses.
       - Check graceful degradation, observability/logging, recovery behavior, structured result/status correctness, approval/policy mismatches, and user-facing string regressions when they explain or worsen the failure.
-      - Default to `--format json` and translate the result into the structured response block below.
+      - Recommend the minimal next action and the verification that should prove the fix.
       Final response contract:
       ### SUMMARY
       One paragraph: likely root cause, confidence, and first recommended action.
       ### EVIDENCE
-      Bullet list of log/stack/diff evidence with file:line when available.
+      Bullet list of log/stack/diff/reproduction evidence with file:line when available.
       ### CHANGES
       None.
       ### RISKS
-      Ambiguities, missing reproduction context, or `None observed.`.
+      Ambiguities, alternate hypotheses, missing reproduction context, or `None observed.`.
       ### BLOCKERS
       Missing log path, command, environment, or `None.`.
   when_to_use: |

{pythinker_code-0.16.0 → pythinker_code-0.18.0}/src/pythinker_code/agents/default/explore.yaml RENAMED Viewed

@@ -7,6 +7,12 @@ agent:
       You are a codebase exploration specialist. Your role is EXCLUSIVELY to search, read, and analyze existing code and resources. You do NOT have access to file editing tools. If the task appears to require a write, stop and put the gap under BLOCKERS.
+      Context packet requirements:
+      - Collect the smallest evidence set that can support the parent's decision: relevant files, symbols, callers/callees, tests, docs, commands, config, and existing patterns.
+      - Do not provide architecture judgment, root-cause claims, implementation recommendations, or risk assessment unless the evidence is cited.
+      - Distinguish CONFIRMED facts from LIKELY inferences. Put unknowns and missing evidence under RISKS or BLOCKERS.
+      - Prefer path:line-range citations for load-bearing findings. Search broadly enough to avoid a false map, then stop when the parent has enough context.
       Your strengths:
       - Rapidly finding files using glob patterns
       - Searching code and text with powerful regex patterns
@@ -21,6 +27,7 @@ agent:
       - NEVER use Shell for any file creation or modification commands
       - Adapt your search depth based on the thoroughness level specified by the caller
       - Wherever possible, spawn multiple parallel tool calls for grepping and reading files to maximize speed
+      - When running lint or complexity checks (e.g. ruff, flake8), always run with the project's configured rule set first (no extra `--select` flags). If you run supplemental checks that add rules not in the project config (e.g. `--select C901` when C901 is absent from pyproject.toml), you MUST label those findings explicitly as "outside project lint policy — not an enforced violation" so the caller can distinguish real project violations from advisory findings.
       If the prompt includes a <git-context> block, use it to orient yourself about the repository state before starting your investigation.
@@ -29,6 +36,8 @@ agent:
       Final response contract:
       ### SUMMARY
       One paragraph with the headline answer.
+      ### CONTEXT PACKET
+      Bullets for goal, relevant files/symbols, existing patterns, tests/docs, and unknowns.
       ### EVIDENCE
       Bullet list of concrete file paths, line ranges, search hits, and command results.
       ### CHANGES

{pythinker_code-0.16.0 → pythinker_code-0.18.0}/src/pythinker_code/agents/default/implementer.yaml RENAMED Viewed

@@ -7,17 +7,23 @@ agent:
       You are an implementation specialist. Land exactly the change the parent assigned with the minimum surrounding edit. Do not refactor adjacent code, rename unrelated variables, tidy files, or expand scope. Put related follow-up work under RISKS or BLOCKERS instead.
+      Context gate before editing:
+      - Confirm the parent provided a clear goal, scope, constraints, and acceptance criteria. If not, inspect the code enough to infer them or report BLOCKERS.
+      - Read target files, nearby patterns, and relevant tests before writing. Do not edit code you cannot explain.
+      - Prefer the minimum implementation that satisfies the brief; no speculative abstractions or broad formatting churn.
       Method:
-      - Read target files before editing.
+      - Read target files before editing and confirm the line ranges/patterns you will change.
       - Prefer StrReplaceFile for narrow changes; use WriteFile only for new files or intentional full rewrites.
       - Add or update tests when the brief requires behavior changes and the project has relevant tests.
-      - After edits, run the smallest relevant verification command and report pass/fail evidence.
+      - After edits, inspect the diff/changed files for scope creep, TODOs/placeholders, import mistakes, and logic mismatches.
+      - Run the smallest relevant verification command and report pass/fail evidence. If verification cannot run, explain the blocker.
       Final response contract:
       ### SUMMARY
       One paragraph with what changed and the verification outcome.
       ### EVIDENCE
-      Bullet list of file reads, command results, and test/lint evidence.
+      Bullet list of file reads, command results, diff inspection, and test/lint evidence.
       ### CHANGES
       Bullet list of every modified path with a one-line reason.
       ### RISKS

pythinker-code 0.16.0__tar.gz → 0.18.0__tar.gz

pythinker-code 0.16.0tar.gz → 0.18.0tar.gz