Release notes and changes from the Pi changelog.
New version of pi. Download from npm or view release on GitHub.
.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.New version of pi. Download from npm or view release on GitHub.
google, google-vertex, opencode, openrouter, and vercel-ai-gateway.google-antigravity model catalog.New version of pi. Download from npm or view release on GitHub.
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.SettingsManager.drainErrors() for caller-controlled settings I/O error handling without manager-side console output.FileAuthStorageBackend, InMemoryAuthStorageBackend) and AuthStorage.fromStorage(...) for storage-first auth persistence wiring.claude-sonnet-4-6 model fallback entry to generated model definitions.SettingsManager now uses scoped storage abstraction with per-scope locked read/merge/write persistence for global and project settings.New version of pi. Download from npm or view release on GitHub.
transport setting ("sse", "websocket", "auto") to /settings and settings.json for providers that support multiple transports (currently openai-codex via OpenAI Codex Responses).websockets: boolean to the new transport setting.New version of pi. Download from npm or view release on GitHub.
terminal_input, allowing extensions to consume or transform raw input before normal TUI handling. See docs/extensions.md.--model now supports provider/id, fuzzy matching, and :<thinking> suffixes. See README.md and docs/models.md.gpt-5.3-codex-spark for OpenAI and OpenAI Codex providers.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: 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)message_start, message_update, message_end, tool_execution_start, tool_execution_update, tool_execution_end) (#1375 by @sumeet)terminal_input extension event to intercept, consume, or transform raw terminal input before normal TUI handling.gpt-5.3-codex-spark model definition for OpenAI and OpenAI Codex providers (research preview).New version of pi. Download from npm or view release on GitHub.
ctx.reload(), useful for hot-reloading configuration or restarting the agent. See docs/extensions.md and the reload-runtime example (#1371)-ne (--no-extensions), -ns (--no-skills), and -np (--no-prompt-templates) for faster interactive usage and scripting./export HTML now includes collapsible tool input schemas (parameter names, types, and descriptions), improving session review and sharing workflows (#1416 by @marchellodev).pi.getAllTools() now exposes tool parameters in addition to name and description, enabling richer extension integrations (#1416 by @marchellodev).ctx.reload() to the extension API for programmatic runtime reload (#1371)-ne for --no-extensions, -ns for --no-skills, -np for --no-prompt-templates/export HTML now includes tool input schema (parameter names, types, descriptions) in a collapsible section under each tool (#1416 by @marchellodev)pi.getAllTools() now returns tool parameters in addition to name and description (#1416 by @marchellodev)New version of pi. Download from npm or view release on GitHub.
ctrl+k/ctrl+y/alt+y) and undo (ctrl+z) in the editor input (#1373 by @Perlence)auto model alias (openrouter:auto) for automatic model routing (#1361 by @yogasanas)pasteToEditor in the extension UI context. See docs/extensions.md (#1351 by @kaofelix)pi <package> --help and invalid subcommands now show helpful output instead of failing silently (#1347 by @ferologics)pasteToEditor to extension UI context for programmatic editor paste (#1351 by @kaofelix)auto model alias for automatic model routing (#1361 by @yogasanas)New version of pi. Download from npm or view release on GitHub.
models.json via modelOverrides, allowing customization of built-in provider models without replacing provider model lists. See docs/models.md#per-model-overrides.models.json provider models now merge with built-in models by id, so custom models can be added or replace matching built-ins without full provider replacement. See docs/models.md#overriding-built-in-providers.AWS_BEDROCK_SKIP_AUTH and AWS_BEDROCK_FORCE_HTTP1. See docs/providers.md.models.json provider models behavior from full replacement to merge-by-id with built-in models. Built-in models are now kept by default, and custom models upsert by id.modelOverrides in models.json to customize individual built-in models per provider without full provider replacement (#1332 by @charles-cooper)AWS_BEDROCK_SKIP_AUTH and AWS_BEDROCK_FORCE_HTTP1 environment variables for connecting to unauthenticated Bedrock proxies (#1320 by @virtuald)New version of pi. Download from npm or view release on GitHub.
git:github.tools.sap/org/repo are treated as git packages instead of local paths@ref parsing for shorthand, HTTPS, and SSH source formats, including branch refs with slashesus.anthropic.claude-opus-4-6-v1:0 to us.anthropic.claude-opus-4-6-v1New version of pi. Download from npm or view release on GitHub.
anthropic provider to claude-opus-4-6openai-codex provider to gpt-5.3-codexamazon-bedrock provider to us.anthropic.claude-opus-4-6-v1:0vercel-ai-gateway provider to anthropic/claude-opus-4-6opencode provider to claude-opus-4-6New version of pi. Download from npm or view release on GitHub.
auth.json API keys now support shell command resolution (!command) and environment variable lookup. See docs/providers.md.auth.json now support shell command resolution (!command) and environment variable lookup, matching the behavior in models.jsonminimal-mode.ts example extension demonstrating how to override built-in tool rendering for a minimal display modeNew version of pi. Download from npm or view release on GitHub.
resume as a configurable keybinding action, allowing users to bind a key to open the session resume selector (like newSession, tree, and fork) (#1249 by @juanibiapina)New version of pi. Download from npm or view release on GitHub.
ExtensionAPI.getCommands(), with commands.ts example for invocation patterns. See docs/extensions.md#pigetcommands and examples/extensions/commands.ts.pi install and pi remove, with relative path resolution against the settings file. See docs/packages.md#local-paths.get_commands response and SlashCommandSource type: renamed "template" to "prompt" for consistency with the rest of the codebaseExtensionAPI.getCommands() to let extensions list available slash commands (extensions, prompt templates, skills) for invocation via prompt (#1210 by @w-winter)commands.ts example extension and exported SlashCommandInfo types for command discovery integrations (#1210 by @w-winter)pi install and pi remove with relative paths stored against the target settings file (#1216)New version of pi. Download from npm or view release on GitHub.