Changelog

Release notes and changes from the Pi changelog.

All news
Release notes

Pi 0.58.0

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

New Features

  • Claude Opus 4.6, Sonnet 4.6, and related Bedrock models now use a 1M token context window (up from 200K) (#2135 by @mitsuhiko).
  • Extension tool calls now execute in parallel by default, with sequential tool_call preflight preserved for extension interception.
  • GOOGLE_CLOUD_API_KEY environment variable support for the google-vertex provider as an alternative to Application Default Credentials (#1976 by @gordonhwc).
  • Extensions can supply deterministic session IDs via newSession() (#2130 by @zhahaoyu).

Added

  • Added GOOGLE_CLOUD_API_KEY environment variable support for the google-vertex provider as an alternative to Application Default Credentials (#1976 by @gordonhwc)
  • Added custom session ID support in newSession() for extensions that need deterministic session paths (#2130 by @zhahaoyu)

Changed

  • Changed extension tool interception to use agent-core beforeToolCall and afterToolCall hooks instead of wrapper-based interception. Tool calls now execute in parallel by default, extension tool_call preflight still runs sequentially, and final tool results are emitted in assistant source order.
  • Raised Claude Opus 4.6, Sonnet 4.6, and related Bedrock model context windows from 200K to 1M tokens (#2135 by @mitsuhiko)

Read more

Release notes

Pi 0.57.1

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

New Features

  • Tree branch folding and segment-jump navigation in /tree, with Ctrl+←/Ctrl+→ and Alt+←/Alt+→ shortcuts while ←/→ and Page Up/Page Down remain available for paging. See docs/tree.md and docs/keybindings.md.
  • session_directory extension event for customizing session directory paths before session manager creation. See docs/extensions.md.
  • Digit keybindings (0-9) in the TUI keybinding system, including modified combos like ctrl+1. See docs/keybindings.md.

Added

  • Added /tree branch folding and segment-jump navigation with Ctrl+←/Ctrl+→ and Alt+←/Alt+→, while keeping ←/→ and Page Up/Page Down for paging (#1724 by @Perlence)
  • Added session_directory extension event that fires before session manager creation, allowing extensions to customize the session directory path based on cwd and other factors. CLI --session-dir flag takes precedence over extension-provided paths (#1730 by @hjanuschka).
  • Added digit keys (0-9) to the keybinding system, including Kitty CSI-u and xterm modifyOtherKeys support for bindings like ctrl+1 (#1905)

Read more

Release notes

Pi 0.57.0

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

New Features

  • Extensions can intercept and modify provider request payloads via before_provider_request. See docs/extensions.md#before_provider_request.
  • Extension UIs can use non-capturing overlays with explicit focus control via OverlayOptions.nonCapturing and OverlayHandle.focus() / unfocus() / isFocused(). See docs/extensions.md and ../tui/README.md.
  • RPC mode now uses strict LF-only JSONL framing for robust payload handling. See docs/rpc.md.

Breaking Changes

  • RPC mode now uses strict LF-delimited JSONL framing. Clients must split records on \n only instead of using generic line readers such as Node readline, which also split on Unicode separators inside JSON payloads (#1911)

Added

  • Added before_provider_request extension hook so extensions can inspect or replace provider payloads before requests are sent, with an example in examples/extensions/provider-payload.ts
  • Added non-capturing overlay focus control for extension UIs via OverlayOptions.nonCapturing and OverlayHandle.focus() / unfocus() / isFocused() (#1916 by @nicobailon)

Changed

  • Overlay compositing in extension UIs now uses focus order so focused overlays render on top while preserving stack semantics for show/hide behavior (#1916 by @nicobailon)

Read more

Release notes

Pi 0.56.3

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

New Features

  • claude-sonnet-4-6 model available via the google-antigravity provider (#1859)
  • Custom editors can now define their own onEscape/onCtrlD handlers without being overwritten by app defaults, enabling vim-mode extensions (#1838)
  • Shift+Enter and Ctrl+Enter now work inside tmux via xterm modifyOtherKeys fallback (docs/tmux.md, #1872)
  • Auto-compaction is now resilient to persistent API errors (e.g. 529 overloaded) and no longer retriggers spuriously after compaction (#1834, #1860)

Added

Read more

Release notes

Pi 0.56.2

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

New Features

  • GPT-5.4 support across openai, openai-codex, azure-openai-responses, and opencode, with gpt-5.4 now the default for openai and openai-codex (README.md, docs/providers.md).
  • treeFilterMode setting to choose the default /tree filter mode (default, no-tools, user-only, labeled-only, all) (docs/settings.md, #1852 by @lajarre).
  • Mistral native conversations integration with SDK-backed provider behavior, preserving Mistral-specific thinking and replay semantics (README.md, docs/providers.md, #1716).

Added

  • Added gpt-5.4 model availability for openai, openai-codex, azure-openai-responses, and opencode providers.
  • Added gpt-5.3-codex fallback model availability for github-copilot until upstream model catalogs include it (#1853).
  • Added treeFilterMode setting to choose the default /tree filter mode (default, no-tools, user-only, labeled-only, all) (#1852 by @lajarre).

Changed

  • Updated the default models for the openai and openai-codex providers to gpt-5.4.

Read more

Release notes

Pi 0.56.1

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

Fixed

  • Fixed extension alias fallback resolution to use ESM-aware resolution for jiti aliases in global installs (#1821 by @Perlence)
  • Fixed markdown blockquote rendering to isolate blockquote styling from default text style, preventing style leakage.

Read more

Release notes

Pi 0.56.0

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

New Features

  • Added OpenCode Go provider support with opencode-go model defaults and OPENCODE_API_KEY environment variable support (docs/providers.md, #1757).
  • Added branchSummary.skipPrompt setting to skip branch summarization prompts during tree navigation (docs/settings.md, #1792).
  • Added gemini-3.1-flash-lite-preview fallback model availability for Google provider catalogs when upstream model metadata lags (README.md, #1785).

Breaking Changes

  • Changed scoped model thinking semantics. Scoped entries without an explicit :<thinking> suffix now inherit the current session thinking level when selected, instead of applying a startup-captured default.
  • Moved Node OAuth runtime exports off the top-level @mariozechner/pi-ai entry. OAuth login and refresh must be imported from @mariozechner/pi-ai/oauth (#1814).

Added

  • Added branchSummary.skipPrompt setting to skip the summary prompt when navigating branches (#1792).
  • Added OpenCode Go provider support with opencode-go model defaults and OPENCODE_API_KEY environment variable support (#1757).
  • Added gemini-3.1-flash-lite-preview fallback model availability in provider catalogs when upstream catalogs lag (#1785).

Changed

  • Updated Antigravity Gemini 3.1 model metadata and request headers to match upstream behavior.

Read more

Release notes

Pi 0.55.4

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

New Features

  • Runtime tool registration now applies immediately in active sessions. Tools registered via pi.registerTool() after startup are available to pi.getAllTools() and the LLM without /reload (docs/extensions.md, examples/extensions/dynamic-tools.ts, #1720).
  • Tool definitions can customize the default system prompt with promptSnippet (Available tools) and promptGuidelines (Guidelines) while the tool is active (docs/extensions.md, #1720).
  • Custom tool renderers can suppress transcript output without leaving extra spacing or empty transcript footprint in interactive rendering (docs/extensions.md, #1719).

Added

  • Added optional promptSnippet to ToolDefinition for one-line entries in the default system prompt's Available tools section. Active extension tools appear there when registered and active (#1237 by @semtexzv).
  • Added optional promptGuidelines to ToolDefinition so active tools can append tool-specific bullets to the default system prompt Guidelines section (#1720).

Read more

Release notes

Pi 0.55.2

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

New Features

  • Extensions can dynamically remove custom providers via pi.unregisterProvider(name), restoring any built-in models that were overridden, without requiring /reload (docs).
  • pi.registerProvider() now takes effect immediately when called outside the initial extension load phase (e.g. from a command handler), removing the need for /reload after late registrations.

Added

  • pi.unregisterProvider(name) removes a dynamically registered provider and its models from the registry without requiring /reload. Built-in models that were overridden by the provider are restored (#1669 by @aliou).

Read more

Release notes

Pi 0.55.1

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

New Features

  • Added offline startup mode via --offline (or PI_OFFLINE) to disable startup network operations, with startup network timeouts to avoid hangs in restricted or offline environments.
  • Added gemini-3.1-pro-preview model support to the google-gemini-cli provider (#1599 by @audichuang).

Read more

Release notes

Pi 0.55.0

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

Breaking Changes

  • Resource precedence for extensions, skills, prompts, themes, and slash-command name collisions is now project-first (cwd/.pi) before user-global (~/.pi/agent). If you relied on global resources overriding project resources with the same names, rename or reorder your resources.
  • Extension registration conflicts no longer unload the entire later extension. All extensions stay loaded, and conflicting command/tool/flag names are resolved by first registration in load order.

Read more

Release notes

Pi 0.54.2

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

Fixed

  • Fixed .pi folder being created unnecessarily when only reading settings. The folder is now only created when writing project-specific settings.
  • Fixed extension-driven runtime theme changes to persist in settings so /settings reflects the active currentTheme after ctx.ui.setTheme(...) (#1483 by @ferologics)
  • Fixed interactive mode freezes during large streaming write tool calls by using incremental syntax highlighting while partial arguments stream, with a final full re-highlight after tool-call arguments complete.

Read more

Release notes

Pi 0.54.1

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

Fixed

  • Externalized koffi from bun binary builds, reducing archive sizes by ~15MB per platform (e.g. darwin-arm64: 43MB -> 28MB). Koffi's Windows-only .node file is now shipped alongside the Windows binary only.

Read more

Release notes

Pi 0.54.0

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

Added

  • Added default skill auto-discovery for .agents/skills locations. Pi now discovers project skills from .agents/skills in cwd and ancestor directories (up to git repo root, or filesystem root when not in a repo), and global skills from ~/.agents/skills, in addition to existing .pi skill paths.

Read more

Release notes

Pi 0.53.1

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

Changed

  • Added Gemini 3.1 model catalog entries for all built-in providers that currently expose it: google, google-vertex, opencode, openrouter, and vercel-ai-gateway.
  • Added Claude Opus 4.6 Thinking to the google-antigravity model catalog.

Read more

Release notes

Pi 0.53.0

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

Breaking Changes

  • SettingsManager persistence semantics changed for SDK consumers. Setters now update in-memory state immediately and queue disk writes. Code that requires durable on-disk settings must call await settingsManager.flush().
  • AuthStorage constructor is no longer public. Use static factories (AuthStorage.create(...), AuthStorage.fromStorage(...), AuthStorage.inMemory(...)). This breaks code that used new AuthStorage(...) directly.

Added

  • Added SettingsManager.drainErrors() for caller-controlled settings I/O error handling without manager-side console output.
  • Added auth storage backends (FileAuthStorageBackend, InMemoryAuthStorageBackend) and AuthStorage.fromStorage(...) for storage-first auth persistence wiring.
  • Added Anthropic claude-sonnet-4-6 model fallback entry to generated model definitions.

Changed

  • SettingsManager now uses scoped storage abstraction with per-scope locked read/merge/write persistence for global and project settings.

Read more

Release notes

Pi 0.52.12

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

Added

  • Added transport setting ("sse", "websocket", "auto") to /settings and settings.json for providers that support multiple transports (currently openai-codex via OpenAI Codex Responses).

Changed

  • Interactive mode now applies transport changes immediately to the active agent session.
  • Settings migration now maps legacy websockets: boolean to the new transport setting.

Read more

Release notes

Pi 0.52.11

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

Added

  • Added MiniMax M2.5 model entries for minimax, minimax-cn, openrouter, and vercel-ai-gateway providers, plus minimax-m2.5-free for opencode.

Read more

Release notes

Pi 0.52.10

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

New Features

  • Extension terminal input interception via terminal_input, allowing extensions to consume or transform raw input before normal TUI handling. See docs/extensions.md.
  • Expanded CLI model selection: --model now supports provider/id, fuzzy matching, and :<thinking> suffixes. See README.md and docs/models.md.
  • Safer package source handling with stricter git source parsing and improved local path normalization. See docs/packages.md.
  • New built-in model definition gpt-5.3-codex-spark for OpenAI and OpenAI Codex providers.
  • Improved OpenAI stream robustness for malformed trailing tool-call JSON in partial chunks.
  • Added built-in GLM-5 model support via z.ai and OpenRouter provider catalogs.

Breaking Changes

  • ContextUsage.tokens and ContextUsage.percent are now number | null. After compaction, context token count is unknown until the next LLM response, so these fields return null. Extensions that read ContextUsage must handle the null case. Removed usageTokens, trailingTokens, and lastUsageIndex fields from ContextUsage (implementation details that should not have been public) (#1382 by @ferologics)
  • Git source parsing is now strict without git: prefix: only protocol URLs are treated as git (https://, http://, ssh://, git://). Shorthand sources like github.com/org/repo and git@github.com:org/repo now require the git: prefix. (#1426)

Added

  • Added extension event forwarding for message and tool execution lifecycles (message_start, message_update, message_end, tool_execution_start, tool_execution_update, tool_execution_end) (#1375 by @sumeet)
  • Added terminal_input extension event to intercept, consume, or transform raw terminal input before normal TUI handling.
  • Added gpt-5.3-codex-spark model definition for OpenAI and OpenAI Codex providers (research preview).

Changed

  • Routed GitHub Copilot Claude 4.x models through Anthropic Messages API, with updated Copilot header handling for Claude model requests.

Read more