Changelog

• Fixed extensions setting not respecting package.json pi.extensions manifest when directory is specified directly (#1302 by @hjanuschka)

• Fixed git package parsing fallback for unknown hosts so enterprise git sources like git:github.tools.sap/org/repo are treated as git packages instead of local paths
• Fixed git package @ref parsing for shorthand, HTTPS, and SSH source formats, including branch refs with slashes
• Fixed Bedrock default model ID from us.anthropic.claude-opus-4-6-v1:0 to us.anthropic.claude-opus-4-6-v1
• Fixed Bedrock Opus 4.6 model metadata (IDs, cache pricing) and added missing EU profile
• Fixed Claude Opus 4.6 context window metadata to 200000 for Anthropic and OpenCode providers

• Updated default model for anthropic provider to claude-opus-4-6
• Updated default model for openai-codex provider to gpt-5.3-codex
• Updated default model for amazon-bedrock provider to us.anthropic.claude-opus-4-6-v1:0
• Updated default model for vercel-ai-gateway provider to anthropic/claude-opus-4-6
• Updated default model for opencode provider to claude-opus-4-6

• Claude Opus 4.6 model support.
• GPT-5.3 Codex model support (OpenAI Codex provider only).
• SSH URL support for git packages. See docs/packages.md.
• auth.json API keys now support shell command resolution (!command) and environment variable lookup. See docs/providers.md.
• Model selectors now display the selected model name.

• API keys in auth.json now support shell command resolution (!command) and environment variable lookup, matching the behavior in models.json
• Added minimal-mode.ts example extension demonstrating how to override built-in tool rendering for a minimal display mode
• Added Claude Opus 4.6 model to the model catalog
• Added GPT-5.3 Codex model to the model catalog (OpenAI Codex provider only)
• Added SSH URL support for git packages (#1287 by @markusn)
• Model selectors now display the selected model name (#1275 by @haoqixu)

• Configurable resume keybinding action for opening the session resume selector. See docs/keybindings.md. (#1249 by @juanibiapina)

• Added 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)

• Slash command menu now triggers on the first line even when other lines have content, allowing commands to be prepended to existing text (#1227 by @aliou)

• Changed Bedrock model generation to drop legacy workarounds now handled upstream (#1239 by @unexge)

• Share URLs now default to pi.dev, graciously donated by exe.dev.

• Share URLs now use pi.dev by default while pi.dev and buildwithpi.ai continue to work.

• Command discovery for extensions via ExtensionAPI.getCommands(), with commands.ts example for invocation patterns. See docs/extensions.md#pigetcommands and examples/extensions/commands.ts.
• Local path support for pi install and pi remove, with relative path resolution against the settings file. See docs/packages.md#local-paths.

• RPC get_commands response and SlashCommandSource type: renamed "template" to "prompt" for consistency with the rest of the codebase

• Added ExtensionAPI.getCommands() to let extensions list available slash commands (extensions, prompt templates, skills) for invocation via prompt (#1210 by @w-winter)
• Added commands.ts example extension and exported SlashCommandInfo types for command discovery integrations (#1210 by @w-winter)
• Added local path support for pi install and pi remove with relative paths stored against the target settings file (#1216)

• Extension tool output expansion controls via ExtensionUIContext getToolsExpanded and setToolsExpanded. See docs/extensions.md and docs/rpc.md.

• Added ExtensionUIContext getToolsExpanded and setToolsExpanded for controlling tool output expansion (#1199 by @academo)
• Added install method detection to show package manager specific update instructions (#1203 by @Itsnotaka)

• Extension API switchSession: Extensions can now programmatically switch sessions via ctx.switchSession(sessionPath). See docs/extensions.md. (#1187)
• Clear on shrink setting: New terminal.clearOnShrink setting keeps the editor and footer pinned to the bottom of the terminal when content shrinks. May cause some flicker due to redraws. Disabled by default. Enable via /settings or PI_CLEAR_ON_SHRINK=1 env var.

• Extension tool signature change: ToolDefinition.execute now uses (toolCallId, params, signal, onUpdate, ctx) parameter order to match AgentTool.execute. Previously it was (toolCallId, params, onUpdate, ctx, signal). This makes wrapping built-in tools trivial since the first four parameters now align. Update your extensions by swapping the signal and onUpdate parameters:

  // Before
  async execute(toolCallId, params, onUpdate, ctx, signal) { ... }
  
  // After
  async execute(toolCallId, params, signal, onUpdate, ctx) { ... }

• Android/Termux support: Pi now runs on Android via Termux. Install with:

  pkg install nodejs termux-api git
  npm install -g @mariozechner/pi-coding-agent
  mkdir -p ~/.pi/agent
  echo "You are running on Android in Termux." > ~/.pi/agent/AGENTS.md

  Clipboard operations fall back gracefully when termux-api is unavailable. (#1164)
• Bash spawn hook: Extensions can now intercept and modify bash commands before execution via pi.setBashSpawnHook(). Adjust the command string, working directory, or environment variables. See docs/extensions.md. (#1160 by @mitsuhiko)
• Linux ARM64 musl support: Pi now runs on Alpine Linux ARM64 (linux-arm64-musl) via updated clipboard dependency.
• Nix/Guix support: PI_PACKAGE_DIR environment variable overrides the package path for content-addressed package managers where store paths tokenize poorly. See README.md#environment-variables. (#1153 by @odysseus0)
• Named session filter: /resume picker now supports filtering to show only named sessions via Ctrl+N. Configurable via toggleSessionNamedFilter keybinding. See docs/keybindings.md. (#1128 by @w-winter)
• Typed tool call events: Extension developers can narrow ToolCallEvent types using isToolCallEventType() for better TypeScript support. See docs/extensions.md#tool-call-events. (#1147 by @giuseppeg)
• Extension UI Protocol: Full RPC documentation and examples for extension dialogs and notifications, enabling headless clients to support interactive extensions. See docs/rpc.md#extension-ui-protocol. (#1144 by @aliou)

• Added Linux ARM64 musl (Alpine Linux) support via clipboard dependency update
• Added Android/Termux support with graceful clipboard fallback (#1164)
• Added bash tool spawn hook support for adjusting command, cwd, and env before execution (#1160 by @mitsuhiko)
• Added typed ToolCallEvent.input per tool with isToolCallEventType() type guard for narrowing built-in tool events (#1147 by @giuseppeg)
• Exported discoverAndLoadExtensions from package to enable extension testing without a local repo clone (#1148)
• Added Extension UI Protocol documentation to RPC docs covering all request/response types for extension dialogs and notifications (#1144 by @aliou)
• Added rpc-demo.ts example extension exercising all RPC-supported extension UI methods (#1144 by @aliou)
• Added rpc-extension-ui.ts TUI example client demonstrating the extension UI protocol with interactive dialogs (#1144 by @aliou)
• Added PI_PACKAGE_DIR environment variable to override package path for content-addressed package managers (Nix, Guix) where store paths tokenize poorly (#1153 by @odysseus0)
• /resume session picker now supports named-only filter toggle (default Ctrl+N, configurable via toggleSessionNamedFilter) to show only named sessions (#1128 by @w-winter)

• Added titlebar-spinner.ts example extension that shows a braille spinner animation in the terminal title while the agent is working.
• Added PI_AI_ANTIGRAVITY_VERSION environment variable documentation to help text (#1129)
• Added cacheRetention stream option with provider-specific mappings for prompt cache controls, defaulting to short retention (#1134)

• Added newSession, tree, and fork keybinding actions for /new, /tree, and /fork commands. All unbound by default. (#1114 by @juanibiapina)
• Added retry.maxDelayMs setting to cap maximum server-requested retry delay. When a provider requests a longer delay (e.g., Google's "quota will reset after 5h"), the request fails immediately with an informative error instead of waiting silently. Default: 60000ms (60 seconds). (#1123)
• /resume session picker: new "Threaded" sort mode (now default) displays sessions in a tree structure based on fork relationships. Compact one-line format with message count and age on the right. (#1124 by @pasky)
• Added Qwen CLI OAuth provider extension example. (#940 by @4h9fbZ)
• Added OAuth modifyModels hook support for extension-registered providers at registration time. (#940 by @4h9fbZ)
• Added Qwen thinking format support for OpenAI-compatible completions via enable_thinking. (#940 by @4h9fbZ)
• Added sticky column tracking for vertical cursor navigation so the editor restores the preferred column when moving across short lines. (#1120 by @Perlence)
• Added resources_discover extension hook to supply additional skills, prompts, and themes on startup and reload.

• Multi-file extensions in packages now work correctly. Package resolution now uses the same discovery logic as local extensions: only index.ts (or manifest-declared entries) are loaded from subdirectories, not helper modules. (#1102)

• Added ctx.getSystemPrompt() to extension context for accessing the current effective system prompt (#1098 by @kaofelix)

• OSC 52 clipboard support for SSH/mosh - The /copy command now works over remote connections using the OSC 52 terminal escape sequence. No more clipboard frustration when using pi over SSH. (#1069 by @gturkoglu)
• Vercel AI Gateway routing - Route requests through Vercel's AI Gateway with provider failover and load balancing. Configure via vercelGatewayRouting in models.json. (#1051 by @ben-vargas)
• Character jump navigation - Bash/Readline-style character search: Ctrl+] jumps forward to the next occurrence of a character, Ctrl+Alt+] jumps backward. (#1074 by @Perlence)
• Emacs-style Ctrl+B/Ctrl+F navigation - Alternative keybindings for word navigation (cursor word left/right) in the editor. (#1053 by @ninlds)
• Line boundary navigation - Editor jumps to line start when pressing Up at first visual line, and line end when pressing Down at last visual line. (#1050 by @4h9fbZ)
• Performance improvements - Optimized image line detection and box rendering cache in the TUI for better rendering performance. (#1084 by @can1357)
• set_session_name RPC command - Headless clients can now set the session display name programmatically. (#1075 by @dnouri)
• Disable double-escape behavior - New "none" option for doubleEscapeAction setting completely disables the double-escape shortcut. (#973 by @juanibiapina)

• Added "none" option to doubleEscapeAction setting to disable double-escape behavior entirely (#973 by @juanibiapina)
• Added OSC 52 clipboard support for SSH/mosh sessions. /copy now works over remote connections. (#1069 by @gturkoglu)
• Added Vercel AI Gateway routing support via vercelGatewayRouting in models.json (#1051 by @ben-vargas)
• Added Ctrl+B and Ctrl+F keybindings for cursor word left/right navigation in the editor (#1053 by @ninlds)
• Added character jump navigation: Ctrl+] jumps forward to next character, Ctrl+Alt+] jumps backward (#1074 by @Perlence)
• Editor now jumps to line start when pressing Up at first visual line, and line end when pressing Down at last visual line (#1050 by @4h9fbZ)
• Optimized image line detection and box rendering cache for better TUI performance (#1084 by @can1357)
• Added set_session_name RPC command for headless clients to set session display name (#1075 by @dnouri)

• Kimi For Coding provider: Access Moonshot AI's Anthropic-compatible coding API. Set KIMI_API_KEY environment variable. See README.md#kimi-for-coding.

• Added Kimi For Coding provider support (Moonshot AI's Anthropic-compatible coding API). Set KIMI_API_KEY environment variable. See README.md#kimi-for-coding.

• Hugging Face provider: Access Hugging Face models via OpenAI-compatible Inference Router. Set HF_TOKEN environment variable. See README.md#hugging-face.
• Extended prompt caching: PI_CACHE_RETENTION=long enables 1-hour caching for Anthropic (vs 5min default) and 24-hour for OpenAI (vs in-memory default). Only applies to direct API calls. See README.md#prompt-caching.
• Configurable autocomplete height: autocompleteMaxVisible setting (3-20 items, default 5) controls dropdown size. Adjust via /settings or settings.json.
• Shell-style keybindings: alt+b/alt+f for word navigation, ctrl+d for delete character forward. See docs/keybindings.md.
• RPC get_commands: Headless clients can now list available commands programmatically. See docs/rpc.md.

• Added Hugging Face provider support via OpenAI-compatible Inference Router (#994)
• Added PI_CACHE_RETENTION environment variable to control cache TTL for Anthropic (5m vs 1h) and OpenAI (in-memory vs 24h). Set to long for extended retention. (#967)
• Added autocompleteMaxVisible setting for configurable autocomplete dropdown height (3-20 items, default 5) (#972 by @masonc15)
• Added /files command to list all file operations (read, write, edit) in the current session
• Added shell-style keybindings: alt+b/alt+f for word navigation, ctrl+d for delete character forward (when editor has text) (#1043 by @jasonish)
• Added get_commands RPC method for headless clients to list available commands (#995 by @dnouri)

• Improved extractCursorPosition performance in TUI: scans lines in reverse order, early-outs when cursor is above viewport (#1004 by @can1357)
• Autocomplete improvements: better handling of partial matches and edge cases (#1024 by @Perlence)

• Git extension updates now handle force-pushed remotes gracefully instead of failing (#961 by @aliou)
• Extension ctx.newSession({ setup }) now properly syncs agent state and renders messages after setup callback runs (#968)
• Fixed extension UI bindings not initializing when starting with no extensions, which broke UI methods after /reload
• Fixed /hotkeys output to title-case extension hotkeys (#969 by @Perlence)
• Fixed model catalog generation to exclude deprecated OpenCode Zen models (#970 by @DanielTatarkin)
• Fixed git extension removal to prune empty directories

• Pi packages for bundling and installing extensions, skills, prompts, and themes. See docs/packages.md.
• Hot reload (/reload) of resources including AGENTS.md, SYSTEM.md, APPEND_SYSTEM.md, prompt templates, skills, themes, and extensions. See README.md#commands and README.md#context-files.
• Custom providers via pi.registerProvider() for proxies, custom endpoints, OAuth or SSO flows, and non-standard streaming APIs. See docs/custom-provider.md.
• Azure OpenAI Responses provider support with deployment-aware model mapping. See docs/providers.md#azure-openai.
• OpenRouter routing support for custom models via openRouterRouting. See docs/providers.md#api-keys and docs/models.md.
• Skill invocation messages are now collapsible and skills can opt out of model invocation via disable-model-invocation. See docs/skills.md#frontmatter.
• Session selector renaming and configurable keybindings. See README.md#commands and docs/keybindings.md.
• models.json headers can resolve environment variables and shell commands. See docs/models.md#value-resolution.
• --verbose CLI flag to override quiet startup. See README.md#cli-reference.

Read the fully revamped docs in README.md, or have your clanker read them for you.

There are multiple SDK breaking changes since v0.49.3. For the quickest migration, point your agent at packages/coding-agent/docs/sdk.md, the SDK examples in packages/coding-agent/examples/sdk, and the SDK source in packages/coding-agent/src/core/sdk.ts and related modules.

• Header values in models.json now resolve environment variables (if a header value matches an env var name, the env var value is used). This may change behavior if a literal header value accidentally matches an env var name. (#909)
• External packages (npm/git) are now configured via packages array in settings.json instead of extensions. Existing npm:/git: entries in extensions are auto-migrated. (#645)
• Resource loading now uses ResourceLoader only and settings.json uses arrays for extensions, skills, prompts, and themes (#645)
• Removed discoverAuthStorage and discoverModels from the SDK. AuthStorage and ModelRegistry now default to ~/.pi/agent paths unless you pass an agentDir (#645)

• Session renaming in /resume picker via Ctrl+R without opening the session (#863 by @svkozak)
• Session selector keybindings are now configurable (#948 by @aos)
• disable-model-invocation frontmatter field for skills to prevent agentic invocation while still allowing explicit /skill:name commands (#927)
• Exposed copyToClipboard utility for extensions (#926 by @mitsuhiko)
• Skill invocation messages are now collapsible in chat output, showing collapsed by default with skill name and expand hint (#894)
• Header values in models.json now support environment variables and shell commands, matching apiKey resolution (#909)
• Added HTTP proxy environment variable support for API requests (#942 by @haoqixu)
• Added OpenRouter provider routing support for custom models via openRouterRouting compat field (#859 by @v01dpr1mr0s3)
• Added azure-openai-responses provider support for Azure OpenAI Responses API. (#890 by @markusylisiurunen)
• Added changelog link to update notifications (#925 by @dannote)
• Added --verbose CLI flag to override quietStartup setting (#906 by @Perlence)
• markdown.codeBlockIndent setting to customize code block indentation in rendered output
• Extension package management with pi install, pi remove, pi update, and pi list commands (#645)
• Package filtering: selectively load resources from packages using object form in packages array (#645)
• Glob pattern support with minimatch in package filters, top-level settings arrays, and pi manifest (e.g., "!funky.json", "*.ts") (#645)
• /reload command to reload extensions, skills, prompts, and themes (#645)
• pi config command with TUI to enable/disable package and top-level resources via patterns (#938)
• CLI flags for --skill, --prompt-template, --theme, --no-prompt-templates, and --no-themes (#645)
• Package deduplication: if same package appears in global and project settings, project wins (#645)
• Unified collision reporting with ResourceDiagnostic type for all resource types (#645)
• Show provider alongside the model in the footer if multiple providers are available
• Custom provider support via pi.registerProvider() with streamSimple for custom API implementations
• Added custom-provider.ts example extension demonstrating custom Anthropic provider with OAuth

• /resume picker sort toggle moved to Ctrl+S to free Ctrl+R for rename (#863 by @svkozak)
• HTML export: clicking a sidebar message now navigates to its newest leaf and scrolls to it, instead of truncating the branch (#853 by @mitsuhiko)
• HTML export: active path is now visually highlighted with dimmed off-path nodes (#929 by @hewliyang)
• Azure OpenAI Responses provider now uses base URL configuration with deployment-aware model mapping and no longer includes service tier handling
• /reload now re-renders the entire scrollback so updated extension components are visible immediately (#928 by @ferologics)
• Skill, prompt template, and theme discovery now use settings and CLI path arrays instead of legacy filters (#645)