Changelog

Release notes and changes from the Pi changelog.

All news
Release notes

Pi 0.80.4

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

New Features

Added

  • Added inherited OpenAI GPT-5.6 model metadata for gpt-5.6, gpt-5.6-sol, gpt-5.6-terra, and gpt-5.6-luna, plus verified openai-codex support for gpt-5.6-sol, gpt-5.6-terra, and gpt-5.6-luna.
  • Added inherited Claude Sonnet 5 to the GitHub Copilot model catalog (#6200).
  • Added inherited zstd request-body compression for the OpenAI Codex Responses SSE transport.
  • Added /login <provider> support with provider autocomplete.
  • Added public SDK exports for CLI-equivalent model and scoped-model resolution (#6201).
  • Added extension and RPC agent_settled events plus session-level idle waiting for fully settled agent runs (#6363).
  • Added before_provider_headers extension hook support for injecting provider request headers (#6350 by @pmateusz).
  • Added an InlineExtension type for named inline extension factories (#6267 by @any-victor).
  • Added extension entry renderers for persisted display-only session entries that are rendered in interactive mode without being sent to the model context.
  • Added project-local resource override management to pi config, including project mode startup with pi config -l and Tab switching between global and project scopes (#6309).
  • Added inherited InMemorySessionStorage and JsonlSessionStorage exports from the agent harness (#6435).
  • Added inherited custom metadata support in JSONL session headers (#6417 by @ArcadiaLin).
  • Added a showCacheMissNotices setting and /settings toggle for significant prompt-cache miss transcript notices.

Removed

  • Removed default attribution headers from Vercel AI Gateway requests.

Read more

Release notes

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

Read more

Release notes

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.

Read more

Release notes

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.

Read more

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