Release notes, project updates, and announcements from the Pi team.
New version of pi. Download from npm or view release on GitHub.
ApiKeyCredential to use the auth.json-compatible discriminator type: "api_key" and provider-scoped env values instead of type: "api-key" and metadata.ExecutionEnvExecOptions to ShellExecOptions.New version of pi. Download from npm or view release on GitHub.
AWS_PROFILE endpoint resolution for built-in inference profile endpoints.New version of pi. Download from npm or view release on GitHub.
Ctrl+J as a default newline keybinding alongside Shift+Enter.zai provider label to ZAI Coding Plan (Global) for clarity (#5965).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.@earendil-works/pi-ai/base and @earendil-works/pi-agent-core/base entrypoints; use the root packages with explicit Models provider factories instead.New version of pi. Download from npm or view release on GitHub.
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.pi update installs the exact checked Pi version, and update notices show the changelog URL, making upgrades more predictable. See Install and Manage.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).New version of pi. Download from npm or view release on GitHub.
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.xhigh thinking support, improving /model behavior and high-effort reasoning for GLM-5.2 users. See Model Options.chat-template thinking support for OpenAI-compatible providers that use chat_template_kwargs, such as DeepSeek models behind vLLM (#5673).New version of pi. Download from npm or view release on GitHub.
@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.openrouter/fusion is available as a built-in OpenRouter model alias. See API Keys.@earendil-works/pi-ai/base and @earendil-works/pi-agent-core/base entry points for selective provider registration in bundled applications (#5348 by @FredKSchott).prompt_cache_key, including cached-token usage and cost accounting (#5854).openrouter/fusion (#5866 by @dannote).New version of pi. Download from npm or view release on GitHub.
/settings can choose separate light and dark themes and follow terminal color-scheme changes. See Selecting a Theme.pi update now updates pi only, with pi update --all for updating pi and packages together. See Install and Manage.CONFIG_DIR_NAME for project config paths and import edit diff helpers for edit-style diffs. See ctx.cwd and SDK Exports./settings can use separate light and dark themes and follow terminal color-scheme changes (#5874).CONFIG_DIR_NAME from the coding-agent public API so extensions can resolve project config paths without hardcoding .pi (#5869 by @xl0).generateDiffString, generateUnifiedPatch, and EditDiffResult) from the public API for extensions that need edit-style diffs (#5756 by @xl0).pi update to update only pi, added pi update --all for updating pi and extensions together, and clarified extension update prompts./ in theme names for automatic light/dark theme settings..pi paths.New version of pi. Download from npm or view release on GitHub.
fetch override instead of reinstalling the undici global fetch over it.thinking: { type: "disabled" } compatibility parameter.New version of pi. Download from npm or view release on GitHub.
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.httpProxy once in global settings to apply HTTP_PROXY and HTTPS_PROXY to Pi-managed HTTP clients. See Network.http-referer and x-title) for Vercel AI Gateway models (#5798 by @rwachtler).xp footer marker when experimental features are enabled.httpProxy setting that applies as HTTP_PROXY and HTTPS_PROXY for Pi-managed HTTP clients (#5790).auth.json API key env values so provider-specific environment overrides can be scoped to Pi and propagated to inherited provider configuration (#5728).marked 18.0.5.New version of pi. Download from npm or view release on GitHub.
dark or light theme. See Selecting a Theme.SHA256SUMS files for verifying standalone binary downloads. See Quickstart Install.New version of pi. Download from npm or view release on GitHub.
New version of pi. Download from npm or view release on GitHub.
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).New version of pi. Download from npm or view release on GitHub.
xhigh effort support.${1:-7} for optional values. See Prompt Template Arguments.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().# or $ so suggestions open without slash-command prefixes. See Autocomplete Providers.${1:-7} (#5553 by @dannote).areExperimentalFeaturesEnabled feature guard to allow users to opt in to early features (#5547 by @vegarsti).ctx.isProjectTrusted() for extensions to observe the effective project trust decision, including temporary trust decisions (#5523).defaultProjectTrust setting to choose whether unresolved project trust asks, always trusts, or never trusts by default.ctx.ui.addAutocompleteProvider() wrappers (#4703).@earendil-works/pi-ai for the Anthropic and Amazon Bedrock providers, with adaptive thinking and xhigh effort support.New version of pi. Download from npm or view release on GitHub.
--approve / --no-approve controls for non-interactive modes. See Project Trust.project_trust, decide, remember, or defer project trust before project-local resources load. See project_trust.CH). See Interactive Mode.project_trust extension event so global and CLI extensions can decide or defer project trust during startup and runtime cwd switches.New version of pi. Download from npm or view release on GitHub.
ctx.mode and ctx.getSystemPromptOptions() to adapt behavior across TUI, RPC, JSON, and print modes and inspect base system prompt inputs. See Extensions.@earendil-works/pi-ai for the minimax and minimax-cn direct providers (#5313).ctx.mode to extension contexts so extensions can distinguish TUI, RPC, JSON, and print mode.ctx.getSystemPromptOptions() for extension commands to inspect the current base system prompt inputs (#5306 by @xl0).New version of pi. Download from npm or view release on GitHub.
--name / -n sets the session display name before startup across interactive, print, JSON, and RPC modes. See Naming Sessions and Session Options.file:// hyperlinks when the terminal supports them, including supported tmux clients.convertToPng for extension authors (#5167 by @xl0).parseArgs and type Args for extension authors (#5202 by @xl0).--name / -n to set the session display name at startup (#5153).file:// hyperlinks to file paths shown in built-in file tool titles (#5189 by @mpazik).@earendil-works/pi-ai (#5178 by @stephanmck).New version of pi. Download from npm or view release on GitHub.
--exclude-tools / -xt disables specific built-in, extension, or custom tools while leaving the rest available. See Tool Options./login can use device-code auth for ChatGPT Plus/Pro Codex subscriptions. See Subscriptions and OpenAI Codex.InputEvent.streamingBehavior. See Input Events.--exclude-tools / -xt to disable specific built-in, extension, or custom tools while leaving the rest available (#5109).streamingBehavior to extension input events so extensions can distinguish idle prompts from mid-stream steers and queued follow-ups (#5107 by @DanielThomas).New version of pi. Download from npm or view release on GitHub.
--session-id <id> lets scripts create or resume an exact project-local session. See Sessions.excludeFromContext to bash for commands whose output should not be sent with the next prompt. See RPC mode.retry.provider.maxRetries controls provider retries instead of hidden SDK defaults. See Retry settings.New version of pi. Download from npm or view release on GitHub.
read tool cards now show only the read line by default, while Ctrl+O still expands the full file content.pi update and git package installs now reconcile pinned git refs and keep package settings intact. See Packages.compat.forceAdaptiveThinking. See Custom providers and Models.compat.forceAdaptiveThinking support to custom Anthropic-compatible model configuration docs and validation (#4797 by @mbazso).koffi dependency for Windows VT input with a tiny vendored native helper, reducing install size while preserving Shift+Tab handling (#4480).npm install --ignore-scripts (#4868).New version of pi. Download from npm or view release on GitHub.
pi update runs, so users can see the installed version's changelog before continuing (#4724 by @mitsuhiko).npm-shrinkwrap.json to lock transitive dependencies for the CLI package.