News

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

ChangelogRSS Feed
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.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

Release notes

Pi 0.74.1

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

New Features

  • Image generation support - Added image generation APIs, generated image model metadata, and built-in OpenRouter image generation support inherited from @earendil-works/pi-ai.
  • Together AI provider - Added Together AI as a built-in provider with /login API-key auth, default model resolution, and setup docs. See README.md#providers--models and docs/providers.md.
  • Windows ARM64 standalone binaries - Added standalone release artifacts for Windows ARM64.
  • Improved terminal and markdown rendering - Added markdown list indentation, task-list checkbox rendering, large markdown robustness, and inline image placement fixes inherited from @earendil-works/pi-tui.

Added

  • Added image generation support from @earendil-works/pi-ai, including image generation APIs, image model metadata, and built-in OpenRouter image generation support (#3887 by @cristinaponcela).
  • Added Together AI to built-in provider setup, /login API-key auth, and default model resolution (#3624 by @Nutlope).
  • Added Windows ARM64 standalone binary release artifacts (#4458 by @brianmichel).

Read more

Blog

Pi Has a New Home at Earendil

Pi now lives under the Earendil Works GitHub and npm organizations. The old @mariozechner packages are deprecated, and 0.74.0 is the first release from the new home. Read more.

Release notes

Pi 0.73.1

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

New Features

  • Self-update support for the npm scope migration: pi update --self now supports the upcoming package rename from @mariozechner/pi-coding-agent to @earendil-works/pi-coding-agent. After the new package is published, existing global installs can update through the normal self-update flow; pi will uninstall the old global package and install the package name returned by the version check endpoint.
  • Interactive OAuth login selection: OAuth providers can now present multiple login choices in /login, enabling provider-specific interactive authentication flows. See Providers.
  • JSONC-style models.json parsing: models.json now allows comments and trailing commas, making custom provider and model configuration easier to maintain. See Providers and Custom Providers.

Added

  • Added interactive login selection support so OAuth providers can present multiple login choices (#4190 by @mitsuhiko).

Changed

  • Changed pi update --self to honor the active package name returned by the Pi version check endpoint, defaulting to the current package when omitted and uninstalling the old global package before installing a renamed package.
  • Changed extension loading to use upstream jiti 2.7 instead of the @mariozechner/jiti fork (#4244 by @pi0).
  • Changed models.json parsing to allow comments and trailing commas (#4162 by @julien-c).

Read more