pctx-py v0.4.0

Release of pctx-client Python package version 0.4.0

pctx-py v0.3.2

Release of pctx-client Python package version 0.3.2

v0.7.1 - 2026-03-27

Release Notes

Added

• Optional session server metadata system

Changed

Fixed

Install pctx 0.7.1

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/portofcontext/pctx/releases/download/v0.7.1/pctx-installer.sh | sh

Install prebuilt binaries via Homebrew

brew install portofcontext/tap/pctx

Install prebuilt binaries into your npm project

npm install @portofcontext/pctx@0.7.1

Download pctx 0.7.1

File	Platform	Checksum
pctx-aarch64-apple-darwin.tar.gz	Apple Silicon macOS	checksum
pctx-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
pctx-aarch64-unknown-linux-gnu.tar.gz	ARM64 Linux	checksum
pctx-x86_64-unknown-linux-gnu.tar.gz	x64 Linux	checksum

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:

gh attestation verify <file-path of downloaded artifact> --repo portofcontext/pctx

You can also download the attestation from GitHub and verify against that directly:

gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>

v0.7.0 - 2026-03-25

Release Notes

Added

• Upstream MCP connection pooling: PCTX now maintains persistent connections to upstream MCP servers across execute_typescript calls, so stateful upstream servers (e.g. LSP servers, database connections) see a continuous session rather than disconnected requests.
• pctx mcp start --stateful-http: HTTP mode now supports stateful upstream sessions scoped to the MCP session ID. The connection pool is created on the first request and reused for the lifetime of the HTTP session, then torn down when the client sends a DELETE.
• pctx mcp start --stdio: When running as a stdio MCP server (e.g. in Claude Desktop), a single global session is used for the entire process lifetime — upstream MCP servers connect once and stay connected until pctx exits.
• Session server (pctx start): upstream connection pools are now scoped per code mode session — created on first use and cleaned up when the session is deleted.
• ExecuteTypescriptOutput now includes a trace field: a structured record of everything that happened during the execution — the type-check phase, each upstream MCP tool call (including whether the client was served from the connection pool cache), and each callback invocation — all with start/end timestamps.

Changed

Fixed

Install pctx 0.7.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/portofcontext/pctx/releases/download/v0.7.0/pctx-installer.sh | sh

Install prebuilt binaries via Homebrew

brew install portofcontext/tap/pctx

Install prebuilt binaries into your npm project

npm install @portofcontext/pctx@0.7.0

Download pctx 0.7.0

File	Platform	Checksum
pctx-aarch64-apple-darwin.tar.gz	Apple Silicon macOS	checksum
pctx-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
pctx-aarch64-unknown-linux-gnu.tar.gz	ARM64 Linux	checksum
pctx-x86_64-unknown-linux-gnu.tar.gz	x64 Linux	checksum

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:

gh attestation verify <file-path of downloaded artifact> --repo portofcontext/pctx

You can also download the attestation from GitHub and verify against that directly:

gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>

pctx-py v0.3.1

Release of pctx-client Python package version 0.3.1

v0.6.0 - 2026-03-13

Release Notes

Added

• Python @tool decorator now parses docstrings (Google, NumPy, reStructuredText, and Epydoc formats) to extract parameter descriptions, return value descriptions, and detailed function descriptions into tool schemas
• Make code mode config and all tools / descriptions easily configurable from python client
• ToolDisclosure support in python client and unified mcp with pctx mcp start

Changed

• Centralized tool descriptions and workflows in root of the repo and loaded by the various pctx surfaces.
• Unified MCP server no longer returns structured content, most agent frameworks prioritize this, and the structured content is x2 the number of tokens than just the code-mode code

Fixed

• Various pctx mcp dev rendering issues.

Install pctx 0.6.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/portofcontext/pctx/releases/download/v0.6.0/pctx-installer.sh | sh

Install prebuilt binaries via Homebrew

brew install portofcontext/tap/pctx

Install prebuilt binaries into your npm project

npm install @portofcontext/pctx@0.6.0

Download pctx 0.6.0

File	Platform	Checksum
pctx-aarch64-apple-darwin.tar.gz	Apple Silicon macOS	checksum
pctx-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
pctx-aarch64-unknown-linux-gnu.tar.gz	ARM64 Linux	checksum
pctx-x86_64-unknown-linux-gnu.tar.gz	x64 Linux	checksum

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:

gh attestation verify <file-path of downloaded artifact> --repo portofcontext/pctx

You can also download the attestation from GitHub and verify against that directly:

gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>

pctx-py v0.3.0

Release of pctx-client Python package version 0.3.0

v0.6.0-beta.2 - 2026-02-17

Release Notes

Added

• Update the fs-mode generated readme to provide clarity on using cat to read about type definitions. Avoids parameter hallucinations.

Changed

Fixed

Install pctx 0.6.0-beta.2

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/portofcontext/pctx/releases/download/v0.6.0-beta.2/pctx-installer.sh | sh

Install prebuilt binaries via Homebrew

brew install portofcontext/tap/pctx

Install prebuilt binaries into your npm project

npm install @portofcontext/pctx@0.6.0-beta.2

Download pctx 0.6.0-beta.2

File	Platform	Checksum
pctx-aarch64-apple-darwin.tar.gz	Apple Silicon macOS	checksum
pctx-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
pctx-aarch64-unknown-linux-gnu.tar.gz	ARM64 Linux	checksum
pctx-x86_64-unknown-linux-gnu.tar.gz	x64 Linux	checksum

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:

gh attestation verify <file-path of downloaded artifact> --repo portofcontext/pctx

You can also download the attestation from GitHub and verify against that directly:

gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>

pctx-py v0.3.0b1

Release of pctx-client Python package version 0.3.0b1

v0.6.0-beta.1 - 2026-02-14

Release Notes

Added

• Python @tool decorator now parses docstrings (Google, NumPy, reStructuredText, and Epydoc formats) to extract parameter descriptions, return value descriptions, and detailed function descriptions into tool schemas
• Make code mode config and all tools / descriptions easily configurable from python client
• Add just-bash and new execute_bash tool to explore filesystem of the generated sdk

Changed

Fixed

Install pctx 0.6.0-beta.1

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/portofcontext/pctx/releases/download/v0.6.0-beta.1/pctx-installer.sh | sh

Install prebuilt binaries via Homebrew

brew install portofcontext/tap/pctx

Install prebuilt binaries into your npm project

npm install @portofcontext/pctx@0.6.0-beta.1

Download pctx 0.6.0-beta.1

File	Platform	Checksum
pctx-aarch64-apple-darwin.tar.gz	Apple Silicon macOS	checksum
pctx-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
pctx-aarch64-unknown-linux-gnu.tar.gz	ARM64 Linux	checksum
pctx-x86_64-unknown-linux-gnu.tar.gz	x64 Linux	checksum

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:

gh attestation verify <file-path of downloaded artifact> --repo portofcontext/pctx

You can also download the attestation from GitHub and verify against that directly:

gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>