Changelog

Release notes and changes from the Pi changelog.

All news

Release notesJun 30, 2026

Pi 0.80.3

New version of pi. Download from npm or view release on GitHub.

New Features

Anthropic Claude Sonnet 5 support - Claude Sonnet 5 is available through inherited Anthropic-compatible and Bedrock provider catalogs with adaptive thinking enabled. See Providers and Model Options.
Configurable output spacing - outputPad controls horizontal padding for user messages, assistant messages, and thinking blocks. See Settings.
External editor configuration - externalEditor lets Ctrl+G use a configured editor before $VISUAL/$EDITOR fallbacks. See Settings and Keybindings.
Richer RPC session tree access - RPC clients can inspect session entries and tree snapshots with get_entries and get_tree. See get_entries and get_tree.
Extension session metadata updates - Extensions can observe session name changes through session_info_changed. See session_info_changed.
Modern Azure Foundry endpoint support - Azure OpenAI Responses provider setup supports current Microsoft Foundry endpoint URLs. See Azure OpenAI.

Added

Added inherited Anthropic Claude Sonnet 5 model support.
Added get_entries and get_tree RPC commands for reading session entries and tree snapshots over RPC (#6078 by @geraschenko).
Added a package ./rpc-entry export for launching Pi directly in RPC mode.
Added session-name change events for extensions (#6175 by @xl0).
Added inherited Azure OpenAI Responses support for modern Microsoft Foundry endpoint URLs (#6004 by @gukoff).
Added inherited Usage.reasoning token counts for providers that report reasoning/thinking token usage (#6057).
Added an externalEditor settings.json override for Ctrl+G external editor commands, with default fallbacks to Notepad on Windows and nano elsewhere (#6122).
Added an outputPad setting for user message, assistant message, and thinking horizontal padding (#6168).

Changed

Changed the default OpenAI model to gpt-5.5.
Changed inherited OpenAI Codex Responses SSE response-header waits to use the configured HTTP timeout instead of the previous fixed 20 second timeout, reducing false timeouts on slow connections (#4945).

Release notesJun 23, 2026

Pi 0.80.2

New version of pi. Download from npm or view release on GitHub.

Changed

Changed inherited pi-ai ApiKeyCredential to use the auth.json-compatible discriminator type: "api_key" and provider-scoped env values instead of type: "api-key" and metadata.
Renamed the inherited agent-core public harness shell execution options type from ExecutionEnvExecOptions to ShellExecOptions.

Release notesJun 23, 2026

Pi 0.80.1

New version of pi. Download from npm or view release on GitHub.

Fixed

Fixed inherited Amazon Bedrock scoped AWS_PROFILE endpoint resolution for built-in inference profile endpoints.
Fixed inherited Fireworks Anthropic-compatible requests to apply session-affinity and unsupported tool-field defaults for custom Fireworks models.
Fixed inherited Together MiniMax M2.7 metadata to avoid unsupported Together reasoning toggles.

Release notesJun 23, 2026

Pi 0.80.0

New version of pi. Download from npm or view release on GitHub.

Changed

Added Ctrl+J as a default newline keybinding alongside Shift+Enter.
Renamed the displayed zai provider label to ZAI Coding Plan (Global) for clarity (#5965).
pi-ai's old global API (stream/complete/completeSimple, getModel/getModels/getProviders, registerApiProvider, getEnvApiKey, ...) moved off the @earendil-works/pi-ai root entrypoint to @earendil-works/pi-ai/compat. Extensions are not affected at runtime: the extension loader resolves the pi-ai root to the compat entrypoint (a strict superset), so existing extensions keep working unchanged. Extension sources that typecheck against pi-ai's published types should switch those imports to @earendil-works/pi-ai/compat (or migrate to the new createModels()/provider-factory API). The compat entrypoint and the loader alias will be removed in a future release with a migration guide.

Removed

Removed inherited selective-provider @earendil-works/pi-ai/base and @earendil-works/pi-agent-core/base entrypoints; use the root packages with explicit Models provider factories instead.

Release notesJun 22, 2026

Pi 0.79.10

New version of pi. Download from npm or view release on GitHub.

New Features

Extension compaction event context - Extension session_before_compact and session_compact events now include reason and willRetry, so extensions can distinguish manual /compact, threshold auto-compaction, and overflow retry flows. See session_before_compact / session_compact and Custom Summarization via Extensions.
Safer update flow - pi update installs the exact checked Pi version, and update notices show the changelog URL, making upgrades more predictable. See Install and Manage.

Added

Added reason and willRetry metadata to extension session_before_compact and session_compact events so extensions can distinguish manual, threshold, and overflow compaction flows (#5962 by @PizzaMarinara).

Release notesJun 20, 2026

Pi 0.79.9

New version of pi. Download from npm or view release on GitHub.

New Features

Chat-template thinking compatibility - OpenAI-compatible custom providers can map Pi thinking levels into chat_template_kwargs, enabling vLLM/Hugging Face chat-template models such as DeepSeek to use provider-native thinking controls. See Custom Provider API Types and OpenAI Compatibility.
GLM-5.2 provider improvements - GLM-5.2 now has corrected Fireworks OpenAI-compatible routing and OpenRouter xhigh thinking support, improving /model behavior and high-effort reasoning for GLM-5.2 users. See Model Options.

Added

Added inherited configurable chat-template thinking support for OpenAI-compatible providers that use chat_template_kwargs, such as DeepSeek models behind vLLM (#5673).

Release notesJun 19, 2026

Pi 0.79.8

New version of pi. Download from npm or view release on GitHub.

New Features

Selective provider base entry points - SDK users can pair @earendil-works/pi-ai/base and @earendil-works/pi-agent-core/base with explicit provider registration to keep bundled applications from including unused provider transports. See pi-ai Base Entry Point and pi-agent-core Base Entry Point.
Mistral prompt caching - Mistral sessions now use provider-side prompt caching with session affinity and cached-token usage/cost accounting. See API Keys and Environment Variables.
Post-compaction token estimates - Compact results and compaction events now include estimated post-compaction token counts so clients can show the approximate context reduction. See RPC compact and compaction events.
OpenRouter Fusion alias - openrouter/fusion is available as a built-in OpenRouter model alias. See API Keys.

Added

Added inherited @earendil-works/pi-ai/base and @earendil-works/pi-agent-core/base entry points for selective provider registration in bundled applications (#5348 by @FredKSchott).
Added inherited Mistral prompt caching using the pi session ID as prompt_cache_key, including cached-token usage and cost accounting (#5854).
Added estimated post-compaction token counts to compact results and compaction events (#5877).
Added the inherited OpenRouter Fusion alias as openrouter/fusion (#5866 by @dannote).

Release notesJun 18, 2026

Pi 0.79.7

New version of pi. Download from npm or view release on GitHub.

New Features

Automatic theme mode - /settings can choose separate light and dark themes and follow terminal color-scheme changes. See Selecting a Theme.
Self-only updates by default - pi update now updates pi only, with pi update --all for updating pi and packages together. See Install and Manage.
Extension API helpers - extensions can use CONFIG_DIR_NAME for project config paths and import edit diff helpers for edit-style diffs. See ctx.cwd and SDK Exports.
Warp inline images - Warp terminals now get inline image rendering through Kitty graphics detection. See Image.

Added

Added automatic theme mode so /settings can use separate light and dark themes and follow terminal color-scheme changes (#5874).
Added inherited Warp terminal image capability detection so inline images render through Warp's Kitty graphics support (#5841 by @dodiego).
Exported CONFIG_DIR_NAME from the coding-agent public API so extensions can resolve project config paths without hardcoding .pi (#5869 by @xl0).
Exported edit diff helpers (generateDiffString, generateUnifiedPatch, and EditDiffResult) from the public API for extensions that need edit-style diffs (#5756 by @xl0).

Changed

Changed bare pi update to update only pi, added pi update --all for updating pi and extensions together, and clarified extension update prompts.
Reserved / in theme names for automatic light/dark theme settings.
Updated extension docs, examples, runtime help, trust prompts, and config labels to use the configured project config directory instead of hardcoded .pi paths.

Release notesJun 16, 2026

Pi 0.79.6

New version of pi. Download from npm or view release on GitHub.

Fixed

Fixed HTTP dispatcher configuration to preserve a caller's deliberate fetch override instead of reinstalling the undici global fetch over it.
Fixed inherited OpenCode Go DeepSeek V4 thinking-off requests to send the provider's thinking: { type: "disabled" } compatibility parameter.

Release notesJun 16, 2026

Pi 0.79.5

New version of pi. Download from npm or view release on GitHub.

New Features

Provider-scoped API key environments - auth.json API key entries can now include env overrides for provider-specific Cloudflare, Azure OpenAI, Google Vertex, Amazon Bedrock, cache retention, and proxy settings without changing the project shell. See Auth File.
Global HTTP proxy setting - Configure httpProxy once in global settings to apply HTTP_PROXY and HTTPS_PROXY to Pi-managed HTTP clients. See Network.
Vercel AI Gateway attribution - Vercel AI Gateway requests now include Pi attribution headers by default. See API Keys.

Added

Added Vercel AI Gateway request attribution headers (http-referer and x-title) for Vercel AI Gateway models (#5798 by @rwachtler).
Added an xp footer marker when experimental features are enabled.
Added a global httpProxy setting that applies as HTTP_PROXY and HTTPS_PROXY for Pi-managed HTTP clients (#5790).
Added auth.json API key env values so provider-specific environment overrides can be scoped to Pi and propagated to inherited provider configuration (#5728).

Changed

Updated the vendored Markdown parser used by HTML session exports to marked 18.0.5.

Release notesJun 15, 2026

Pi 0.79.4

New version of pi. Download from npm or view release on GitHub.

New Features

Automatic first-run theme selection - pi detects the terminal background on first run and defaults to the dark or light theme. See Selecting a Theme.
Standalone binary integrity checksums - GitHub release assets now include SHA256SUMS files for verifying standalone binary downloads. See Quickstart Install.

Added

Added SHA256SUMS integrity files to standalone binary GitHub release assets (#5739).
Added first-run interactive theme detection from the terminal background (#5385 by @vegarsti).

Release notesJun 13, 2026

Pi 0.79.3

New version of pi. Download from npm or view release on GitHub.

Fixed

Fixed inherited OpenAI GPT-5.4/GPT-5.5 and OpenAI Codex GPT-5.4/GPT-5.4 mini/GPT-5.5 context window metadata to use the observed 272k-token Codex backend limit, avoiding a billing hazard from prompts above Codex's accepted limit (reported by @trethore).

Release notesJun 12, 2026

Pi 0.79.2

New version of pi. Download from npm or view release on GitHub.

New Features

Clearer Bedrock validation guidance - Amazon Bedrock data retention validation errors now link to AWS data retention documentation. See Amazon Bedrock.

Added

Added an experimental first-time setup flow behind PI_EXPERIMENTAL=1 that asks for a dark/light theme choice (preselecting the detected appearance) and opt-in analytics data sharing on first launch with the default agent directory; opting in stores a trackingId in settings.json (#5587 by @vegarsti).
Added AWS data retention documentation links to inherited Amazon Bedrock unsupported data retention mode validation errors (#5561 by @unexge).

Release notesJun 9, 2026

Pi 0.79.1

New version of pi. Download from npm or view release on GitHub.

New Features

Claude Fable 5 - Claude Fable 5 is now available on the Anthropic and Amazon Bedrock providers, with adaptive thinking and xhigh effort support.
Prompt template defaults - Prompt templates can use default positional arguments such as ${1:-7} for optional values. See Prompt Template Arguments.
Configurable project trust defaults - defaultProjectTrust lets users choose whether unresolved project trust asks, always trusts, or never trusts by default, and extensions can inspect effective trust decisions. See Project Trust and ctx.isProjectTrusted().
Natural extension autocomplete triggers - Extension autocomplete providers can declare trigger characters such as # or $ so suggestions open without slash-command prefixes. See Autocomplete Providers.

Added

Added default-value expansion for prompt template positional arguments, e.g. ${1:-7} (#5553 by @dannote).
Added areExperimentalFeaturesEnabled feature guard to allow users to opt in to early features (#5547 by @vegarsti).
Added ctx.isProjectTrusted() for extensions to observe the effective project trust decision, including temporary trust decisions (#5523).
Added a global defaultProjectTrust setting to choose whether unresolved project trust asks, always trusts, or never trusts by default.
Added extension autocomplete trigger character support for ctx.ui.addAutocompleteProvider() wrappers (#4703).
Added Claude Fable 5 model support inherited from @earendil-works/pi-ai for the Anthropic and Amazon Bedrock providers, with adaptive thinking and xhigh effort support.

Release notesJun 8, 2026

Pi 0.79.0

New version of pi. Download from npm or view release on GitHub.

New Features

Project trust for local inputs - Pi now asks before loading project-local settings, resources, instructions, and packages, with saved decisions and --approve / --no-approve controls for non-interactive modes. See Project Trust.
Extension-controlled trust decisions - Global and CLI extensions can handle project_trust, decide, remember, or defer project trust before project-local resources load. See project_trust.
Cache-hit visibility in the footer - The interactive footer now shows the latest prompt cache hit rate (CH). See Interactive Mode.
Richer SDK and RPC extension surfaces - Public exports now include RPC extension UI request/response types and package asset path helpers. See Extension UI Protocol and SDK Exports.

Added

Added a project_trust extension event so global and CLI extensions can decide or defer project trust during startup and runtime cwd switches.
Added project trust gating for project-local settings, resources, instructions, and packages (#5332).
Added the latest prompt cache hit rate to the interactive footer.
Exported RPC extension UI request and response types from the public API (#5455).
Exported coding-agent package asset path helpers from the public API (#5415).

Release notesJun 4, 2026

Pi 0.78.1

New version of pi. Download from npm or view release on GitHub.

New Features

More built-in provider coverage - Added Ant Ling and NVIDIA NIM provider setup, plus MiniMax-M3 support for the direct MiniMax providers. See Providers.
Richer extension context - Extensions can use ctx.mode and ctx.getSystemPromptOptions() to adapt behavior across TUI, RPC, JSON, and print modes and inspect base system prompt inputs. See Extensions.

Added

Added containerization documentation and a Gondolin extension example for routing built-in tools into a local micro-VM.
Added Ant Ling provider selection and setup documentation.
Added MiniMax-M3 model support inherited from @earendil-works/pi-ai for the minimax and minimax-cn direct providers (#5313).
Added NVIDIA NIM provider selection, setup documentation, and direct NIM request attribution headers.
Added ctx.mode to extension contexts so extensions can distinguish TUI, RPC, JSON, and print mode.
Added ctx.getSystemPromptOptions() for extension commands to inspect the current base system prompt inputs (#5306 by @xl0).

Release notesMay 29, 2026

Pi 0.78.0

New version of pi. Download from npm or view release on GitHub.

New Features

Named startup sessions - --name / -n sets the session display name before startup across interactive, print, JSON, and RPC modes. See Naming Sessions and Session Options.
Clickable file tool paths - built-in file tool titles render OSC 8 file:// hyperlinks when the terminal supports them, including supported tmux clients.

Added

Exported convertToPng for extension authors (#5167 by @xl0).
Exported parseArgs and type Args for extension authors (#5202 by @xl0).
Added --name / -n to set the session display name at startup (#5153).
Added a resume command hint when exiting interactive sessions (#5176 by @yzhg1983).
Added OSC 8 file:// hyperlinks to file paths shown in built-in file tool titles (#5189 by @mpazik).
Added custom Amazon Bedrock request header support inherited from @earendil-works/pi-ai (#5178 by @stephanmck).

Release notesMay 28, 2026

Pi 0.77.0

New version of pi. Download from npm or view release on GitHub.

New Features

Claude Opus 4.8 support - Adds Anthropic Claude Opus 4.8 metadata and updates Opus adaptive-thinking coverage.
Selective tool disablement - --exclude-tools / -xt disables specific built-in, extension, or custom tools while leaving the rest available. See Tool Options.
Headless Codex subscription login - /login can use device-code auth for ChatGPT Plus/Pro Codex subscriptions. See Subscriptions and OpenAI Codex.
Streaming-aware extension input - extensions can distinguish idle prompts, mid-stream steers, and queued follow-ups with InputEvent.streamingBehavior. See Input Events.

Added

Added --exclude-tools / -xt to disable specific built-in, extension, or custom tools while leaving the rest available (#5109).
Added OpenAI Codex subscription device-code login as a selectable headless alternative while keeping browser login as the default (#4911 by @vegarsti).
Added streamingBehavior to extension input events so extensions can distinguish idle prompts from mid-stream steers and queued follow-ups (#5107 by @DanielThomas).
Added Claude Opus 4.8 model metadata for Anthropic and updated Opus adaptive-thinking coverage to use it.

Release notesMay 27, 2026

Pi 0.76.0

New version of pi. Download from npm or view release on GitHub.

New Features

Explicit session IDs for automation - --session-id <id> lets scripts create or resume an exact project-local session. See Sessions.
RPC bash output can stay out of model context - RPC clients can pass excludeFromContext to bash for commands whose output should not be sent with the next prompt. See RPC mode.
More predictable provider retries and timeouts - Codex WebSocket/SSE waits are bounded, and retry.provider.maxRetries controls provider retries instead of hidden SDK defaults. See Retry settings.
Better terminal editing across environments - Apple Terminal Shift+Enter, Windows/JetBrains capability detection, and Unicode-aware word navigation improve interactive editing. See Terminal setup and Keybindings.

Added

Added --session-id to let CLI callers use an exact project-local session ID, creating it if missing (#4874).
Added excludeFromContext flag to the bash RPC command for parity with the internal executeBash API (#5039).

Release notesMay 23, 2026

Pi 0.75.5

New version of pi. Download from npm or view release on GitHub.

New Features

Cleaner read tool output - Collapsed read tool cards now show only the read line by default, while Ctrl+O still expands the full file content.
Faster file tools on Windows - Built-in file tools now use async filesystem operations during streaming, and image resizes run off the main TUI thread in a worker.
More reliable package updates - pi update and git package installs now reconcile pinned git refs and keep package settings intact. See Packages.
Custom Anthropic-compatible adaptive thinking - Custom provider model configs can opt into adaptive-thinking Claude behavior with compat.forceAdaptiveThinking. See Custom providers and Models.

Added

Added compat.forceAdaptiveThinking support to custom Anthropic-compatible model configuration docs and validation (#4797 by @mbazso).
Added a standard unified patch to edit tool result details for SDK consumers (#4821).
Added a Codex subscription login method selector with device-code auth for headless environments.

Changed

Changed collapsed read tool cards to show only the read line until expanded (#4916).
Replaced the inherited optional koffi dependency for Windows VT input with a tiny vendored native helper, reducing install size while preserving Shift+Tab handling (#4480).
Changed the root development install documentation to use npm install --ignore-scripts (#4868).