Changelog

Release notes, project updates, and announcements from the Pi team.

RSS Feed
Release notes

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.

Read more

Release notes

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).

Read more

Release notes

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).

Read more

Release notes

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).

Read more

Release notes

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.

Read more

Release notes

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.

Read more

Release notes

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.

Read more

Release notes

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).

Read more

Release notes

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).

Read more

Release notes

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).

Read more

Release notes

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.

Read more

Release notes

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).

Read more

Release notes

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).

Read more

Release notes

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).

Read more

Release notes

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.

Read more

Release notes

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).

Read more

Release notes

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).

Read more

Release notes

Pi 0.75.4

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

New Features

  • Hardened npm install and release path - Pi now ships the CLI with a generated shrinkwrap for transitive dependencies, blocks accidental lockfile changes, verifies dependency pinning and lifecycle-script allowlists in checks, disables lifecycle scripts for self-update and local release installs where supported, and smoke-tests isolated npm and Bun installs before release. See Supply-chain hardening.

Added

  • Added interactive update notes after pi update runs, so users can see the installed version's changelog before continuing (#4724 by @mitsuhiko).
  • Exported image resize utilities from the package root for SDK consumers (#4775 by @xl0).

Changed

  • Changed source syntax to avoid TypeScript constructs that require JavaScript emit, keeping core sources compatible with Node.js strip-only TypeScript checks.
  • Removed web UI workspace references from the CLI package and dropped the package-level development watch script.
  • Published npm installs now include an npm-shrinkwrap.json to lock transitive dependencies for the CLI package.
  • Improved terminal theme detection for light/dark and truecolor handling.
  • Changed self-update package-manager commands to disable lifecycle scripts during reinstall.

Read more

Release notes

Pi 0.75.3

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

Fixed

  • Fixed undici 8 HTTP/2 destroyed-session races crashing the Node CLI by preserving the previous HTTP/1.1-only fetch dispatcher behavior (#4681).

Read more

Release notes

Pi 0.75.2

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

Fixed

  • Fixed Bun-compiled release binaries failing to start when Bun's built-in undici shim lacks npm undici's install export (#4661 by @dmasiero).
  • Fixed Xiaomi MiMo generated model metadata to replay assistant tool-call messages with reasoning_content for thinking-mode multi-turn requests, inherited from @earendil-works/pi-ai (#4678).
  • Fixed Windows external editor handoff so vim/nvim can receive input after opening from the TUI (#4612).
  • Fixed Windows npm self-updates to move loaded native dependency packages out of the active install before reinstalling pi (#4157).
  • Fixed pi update --self detection for pnpm v11 global installs whose package path resolves through the pnpm store (#4647).
  • Fixed Windows pnpm self-updates to resolve pnpm command shims and run through pnpm instead of requiring manual updates (#4157).
  • Fixed Windows npm-family command execution to use cross-spawn instead of parsing .cmd shim internals (#4665).

Read more