@earendil-works/pi-tui
1.5.2 · 10 Nov 2026MIT9.8M / weekRepositoryHomepagenpmAtom feed
Where each line stands
Plan an upgrade- 1.x1.5.2No known advisoryLatest line
- 0.x0.99.2No known advisoryTo 1.5.2
Latest releases
All 64 releases- 1.x · latest line
1.5.2
10 Nov 2026Fork sessions whose folder is gone: when a session's original folder was moved or deleted, you can now fork it into the current folder instead of only continuing, so later resumes no longer ask. See Continue or switch sessions.
When a session's working directory no longer exists, for example after the project folder was renamed, interactive mode now offers
Continue,Fork, orCancelinstead of only continuing.Continueruns the session in the current directory without storing the choice, as before;Forkcopies it into the current directory as a new session with a new ID, like--fork, so the next resume no longer asks. This applies at startup (--session,--resume), to/resume, to/import, and toctx.switchSession()from extensionsFixed
/importof a session whose working directory no longer exists leaving a copy in the session directory, and continuing it leaving a second copy with the same ID (s.jsonlands-1.jsonl); the failed copy is now removed
New Features
Fork sessions whose folder is gone: when a session's original folder was moved or deleted, you can now fork it into the current folder instead of only continuing, so later resumes no longer ask. See Continue or switch sessions.
Changed
When a session's working directory no longer exists, for example after the project folder was renamed, interactive mode now offers
Continue,Fork, orCancelinstead of only continuing.Continueruns the session in the current directory without storing the choice, as before;Forkcopies it into the current directory as a new session with a new ID, like--fork, so the next resume no longer asks. This applies at startup (--session,--resume), to/resume, to/import, and toctx.switchSession()from extensions
Fixed
Fixed
/importof a session whose working directory no longer exists leaving a copy in the session directory, and continuing it leaving a second copy with the same ID (s.jsonlands-1.jsonl); the failed copy is now removedFixed Anthropic OAuth requests reporting an outdated Claude Code version
1.5.1
9 Nov 2026- Breaking
Custom
GrepOperations.readFilecallbacks are no longer called for context lines. The field remains accepted as optional and deprecated so existing integrations still compile. The grep tool now takes context lines from ripgrep and no longer reads matched files itself. To search a remote system, override grep'sexecute(); see Remote Execution - Breaking
OpenAI-compatible models no longer send
"tools":when all tools are disabled in a session that has used tools; the field is omitted. This fixes 400 errors (tools must not be an empty array) from vLLM 0.20+, also behind LiteLLM. If your proxy requirestoolsonce the history has tool calls, such as older LiteLLM versions in front of Anthropic, setcompat.requiresToolsWithToolHistory: truefor that model inmodels.json Shell login and logout: use
pi auth login <provider>andpi auth logout <provider>without starting a session, with API-key and no-browser sign-in options. See Credential commands.
New Features
Shell login and logout: use
pi auth login <provider>andpi auth logout <provider>without starting a session, with API-key and no-browser sign-in options. See Credential commands.Idle prompt cache warming: eligible caches now stay warm for up to 30 minutes between runs when a refresh is expected to pay for itself. See
cacheWarming.Anthropic message threads: requests send only new messages while the server continues the conversation, with full-request fallback when earlier context changes. See Anthropic compatibility.
Richer Mermaid diagrams: pie charts, author-defined styles, clickable labels on supported terminals, and diagrams in expanded branch and compaction summaries. See Display settings and Markdown transformers.
GitHub Copilot classifiers: call Microsoft-Decision-1 through codemode
models.classify()for typed decisions and probabilities. See Use classifier models.Package update summaries:
pi update --extensionsreports each package's npm version or git commit change and distinguishes unchanged, skipped, and warned updates. See Update Pi or packages.
Breaking Changes
- Breaking
Custom
GrepOperations.readFilecallbacks are no longer called for context lines. The field remains accepted as optional and deprecated so existing integrations still compile. The grep tool now takes context lines from ripgrep and no longer reads matched files itself. To search a remote system, override grep'sexecute(); see Remote Execution - Breaking
OpenAI-compatible models no longer send
"tools":when all tools are disabled in a session that has used tools; the field is omitted. This fixes 400 errors (tools must not be an empty array) from vLLM 0.20+, also behind LiteLLM. If your proxy requirestoolsonce the history has tool calls, such as older LiteLLM versions in front of Anthropic, setcompat.requiresToolsWithToolHistory: truefor that model inmodels.json
Added
pi updatenow lists each updated package with its npm version or git commit change, for examplenpm:foo 1.2.0 -> 1.3.0, and printsPackages are already up to datewhen nothing changed. When nothing changed but an update printed a warning, for example because npm left the old version installed after resolving stale registry metadata, it printsNo packages were updated, see the warnings aboveinstead; in offline mode it printsSkipped package updates (offline mode).PackageManager.update()reports each changed package as a newresultprogress event whosemessageholds that line (#11707, #11711)Anthropic sessions now use message threads: each request sends only the new messages and the server continues from the previous reply, falling back to the full request when the conversation changed (for example after compaction or a tool list change). On by default for the
anthropicprovider onapi.anthropic.com; setcompat.supportsMessageThreadsinmodels.jsonto enable it for gateways that forward thethreadfield, or to turn it off. Cache warming does not touch the session's threadpi.registerMarkdownTransformer()takes an optional{ messageTypes }that selects the Markdown surfaces a transformer runs on. Besides user, assistant, and thinking Markdown, transformers can now opt intocustom(custom messages and skill blocks),summary(branch and compaction summaries), andchangelog(What's New,/changelog, the Extension Updates notice, and the Update Available note). Without options a transformer runs on user, assistant, and thinking Markdown as before. The built-in Mermaid renderer now also draws diagrams in expanded branch and compaction summariespi auth login <provider>logs in to a provider from the shell without starting a session, for examplepi auth login radius. It signs in with an account in the browser and exits;--api-keysaves an API key instead, and--no-browseruses device code or copy-code sign-in instead. Logging in to Radius also configures the Radius MCP server.pi auth logout <provider>removes the stored credentials, like/logoutctx.ui.custom()overlays now honor theblockedoption: pi reports blocked program status (OSC 7501) from when the overlay is shown until it callsdone(), also while it is hidden withsetHidden(). Closing one overlay keeps other open questions blockedAdded the
qwen-token-plan-individual-cnprovider for Qwen Token Plan Individual on the China endpoint, usingQWEN_TOKEN_PLAN_CN_API_KEYAdded Microsoft-Decision-1 classifier support through GitHub Copilot, including codemode
models.classify()Added
compat.promptCacheKeyMode("auto","enabled", or"disabled") to enable prompt cache keys for compatible proxies or omit them for endpoints that reject them. Set it inmodels.jsonwhen using piAdded
compat.requiresNonNullAssistantContentfor OpenAI-compatible endpoints that require an empty string instead ofnullin assistant messages containing only tool calls. Set it inmodels.jsonwhen using piAdded syntax highlighting for Dart, Nix, Groovy, and Gradle files in read and write views
Added GLM 5.3 to the Qwen Token Plan Individual model allowlist
Added Claude Fable 5.2 (
claude-fable-5-2) to theanthropicprovider ($8/$40 per million input/output tokens, 1M context, 128K output). Like Fable 5.1 it uses per-message effort and mid-conversation system messages; requests its safety classifiers refuse before any output are answered by Claude Opus 5 through server-side fallback and billed at Opus 5's price. Claude Fable 5.2 and Mythos 5.2 on other providers, such as OpenRouter'santhropic/claude-fable-5.2, get the same per-message effort support
Changed
The default model for the
anthropicprovider is now Claude Opus 5.5 (claude-opus-5-5) instead of Claude Opus 4.8Default models moved to newer models at the same or a lower price:
amazon-bedrockClaude Opus 5.5,azureGPT-6.1 Sol,googleandgoogle-vertexGemini 4 Argon,vercel-ai-gatewayGLM 5.3,basetenGLM 5.3,minimaxandminimax-cnMiniMax-M3,qwen-token-planandqwen-token-plan-cnQwen3.8 Max,opencode-goKimi K3.1 Pro, and Kimi K2.7 Code instead of Kimi K2.6 formoonshotai,moonshotai-cn,huggingface,opencode,openrouter,cloudflare-workers-aiandcloudflare-ai-gatewaycacheWarmingnow defaults to"idle"instead of"streaming": pi also keeps eligible prompt caches warm for up to 30 minutes between agent runs, but only when a refresh is expected to pay for itself. Set"cacheWarming": "streaming"in global settings for the previous behaviorConsecutive cache warms now show as one
Cache warmed: $<total>line with the cumulative cost instead of one line per warmThe OpenAI Codex provider is shown as "OpenAI Codex" again instead of "OpenAI Codex (legacy)" in
/loginand the model selectorThe
/loginand/logoutprovider lists and/login <provider>completions now show the preferred partners Radius and OpenRouter first, then all other providers alphabetically. In the provider lists, partners are marked with✦, the selected Radius row shimmers in the Radius logo colors and the selected OpenRouter row glows in OpenRouter's brand color (lime on dark themes, violet on light themes)Upgraded terminal Mermaid rendering to support more diagram types, including pie charts, author-defined styles, and clickable labels on terminals with hyperlink support
Fixed
Fixed the grep tool's
globmatching from the folder pi was started in instead of frompath: withpath: "repo",glob: "migrations/main/*.js"returnedNo matches foundeven thoughrepo/migrations/main/a.jsexists. Globs are now relative topath, the same form grep prints its results in, also whenpathis a symlink. A leading./(./src/*.ts) is ignored instead of matching nothing (#11807, #10998)Fixed prompt template arguments dropping apostrophes and merging words: an apostrophe inside a word, as in
doesn't, no longer opens a quote; a quote with no closing match is kept as text; and\"inside"..."(or\'inside'...') gives a literal quoteFixed the bash tool reporting only
Command timed outwhen the command had already exited but a background process it started kept writing to its output until the timeout. The error now also reports the shell's exit code and when it exitedImages in steering and follow-up messages, including
prompt()while streaming, are now resized like images in idle prompts instead of being sent and saved at full sizeA failed token refresh of an MCP connection no longer registers an OAuth client or replaces the PKCE verifier of a sign-in in progress, which made that sign-in fail. MCP sign-in now refreshes the stored tokens with the stored client even when the loopback callback port changed, instead of registering a new client and opening the browser. Ctrl+C in
/mcpand the--timeoutofpi mcp loginnow also stop a sign-in while it waits up to 25 seconds for another pi process's token refresh, and a refresh lock that fails for another reason than that wait now fails the sign-in instead of opening the browser.Fixed
pi mcp listreporting MCP servers with"auth": { "provider": "<provider>" }, such as Radius, as needing sign-in although the provider was signed in: the shell command sent no token. It now sends the provider's/logintoken and refreshes it when it expired. For these servers the sign-in hint names/login <provider>instead ofpi mcp login, andpi mcp loginandpi mcp logoutpoint to/loginand/logoutinstead of failing with "does not use OAuth"Fixed RPC mode ignoring an extension's
ctx.shutdown()while idle, for example from a timer: the process kept running until the client sent another command. pi now shuts down right away when idle, and a shutdown requested by an extension command waits until the command'spromptresponse is writtenFixed changelog notes repeating on every fresh launch when the installed package version has a prerelease suffix, such as
0.1.5-20261020.7: the saved version was read as0.1.0, so the0.1.1to0.1.5notes counted as new each time. A saved version withoutmajor.minor.patchnow shows no notes and is replaced by the installed version, instead of showing the whole changelogFixed RPC mode cutting off shutdown cleanup, such as a pending MCP token refresh, when stdin closed and SIGTERM arrived together, which process managers like Paseo and systemd do. Pi lost the refreshed token and the MCP server revoked the sign-in. Once a shutdown has started, a stdin EOF or a single signal no longer interrupts it; a second signal still exits at once. Print mode likewise no longer dies from a signal that arrives during its final cleanup
Fixed the grep tool reading every matched file into memory when
contextwas set, which ran out of memory on large files; context now comes from ripgrep, which also fixes UTF-16 files and lone CRs in matched lines, and the match limit notice no longer appears when exactlylimitmatches exist (#9276, #11423)Fixed the find tool reporting the result limit when exactly
limitfiles match, andlimit: 0in find and ls returning every result or an empty listing; limits below 1 now mean 1Fixed grep match lines, codemode output, compaction summaries of tool results, and MCP error and server summaries cutting an emoji or other non-BMP character in half when truncating, which left an invalid lone surrogate in the text
Fixed the find tool on Windows returning no results for patterns with Windows separators such as
src\**\*.ts, and for every path pattern such assrc/**/*.tswith fd 10.5.1, which pi now downloads. Windows path patterns now match the same way with every fd version:src/**/*.tsalso finds files directly insrc/, andsrc/*.tsno longer finds files in subdirectoriesFixed the read tool loading whole files into memory, which ran out of memory on large files even with
offset/limit; it now streams the file and keeps only the shown lines. CustomReadOperationscan stream too by providing the new optionalcreateReadStreamFixed OAuth logins such as
openaiandanthropicfailing withinvalid_grantafter pi was stopped while it refreshed an expired token, for example an RPC client that stops pi right after startup while the background catalog refresh runs. The token endpoint had already replaced the refresh token, but pi exited before saving the new one. On exit, pi now waits for a token refresh in progress to be savedFixed Ctrl+P not switching to the only model in scope (or the only available model) when the active model is a different one; it showed "Only one model in scope" instead. Cycling forward from a model outside the scope now also selects the first scoped model instead of skipping it
Fixed
/reloadand session switches leaving extension overlays on screen when an extension had more than onectx.ui.custom({ overlay: true })open: only the topmost overlay was removed, and the others kept focus and input although the extension that opened them was gone. All extension overlays, including hidden ones, are now removed and disposed; pi's own overlays stay openFixed
/mcpsign-in staying on "Connecting…" for minutes after a successful browser sign-in, with Ctrl+C doing nothing: pi waited for the browser to drop an unused connection to the OAuth callback port. The callback server now closes remaining connections when it shuts downFixed pi aborting (
zsh: abort) after repeated image reads, reported on macOS arm64 with Node 24.16. Each image resize starts a worker thread, and pi did not wait for it to stop, so the next resize started a new worker while the previous one was still shutting down. The crash is most likely a Node bug that this overlap triggers and could not be reproduced on Linux; image resizes now wait for the previous worker to stop, which adds about 15 ms per imageFixed
tool_searchandsearchTools()not finding a tool by property names and descriptions behind a local$ref, as in MCP input schemas that put their models in$defs. Referenced definitions are read once, so recursive schemas do not loop, and definitions nothing references stay out of the search textFixed the codemode
resolves tosummary of a tool leaving out field names behind a local$ref, for examplestructuredContent?instead ofstructuredContent?: { results }for MCP output schemas that put their models in$defsFixed every codemode script failing with
URI malformedwhen any callable tool, such as an MCP tool, had a$refwith a malformed percent escape (#/$defs/%E0) in its schema, even scripts that do not call that tool. The parameter now renders asunknownin the tool's declarationFixed
ctrl+onot expanding or collapsing the output of!and!!commands run while the agent is working. New!/!!output now starts in the current expand state, the output no longer disappears when a steering or follow-up message is queued, and it moves into the chat when the agent finishes instead of on the next submitted messageFixed resuming a session restoring an old thinking level after
/treenavigated to before a/thinkingchange. Like the model, the live thinking level is now recorded on the new branch with the next promptFixed inline images in fullscreen mode showing only their first row in Orca, while regular mode showed them in full. Fullscreen now draws Kitty images after the rows they cover on every terminal, as it already did for WezTerm
Fixed the edit tool rewriting the line endings of untouched lines in files with mixed CRLF/LF or lone CR line endings, and running out of memory on large files after the file was already written; the diff now covers only the changed lines and their surroundings and is computed before writing
Fixed the Windows installer (
irm https://pi.dev/install.ps1 | iex) aborting withNativeCommandErrorin Windows PowerShell 5.1 when npm or Node.js printed any warning, for examplenpm warn Unknown user configfrom an unknown.npmrckey. It failed before the action menu when migrating an npm installation, and during managed installs. An invalidmanaged-install.jsonalso aborted the installer instead of being reportedFixed
pi update --modelsfailing withCould not refresh model catalogs: openai: OAuth refresh failed for openai: ... invalid_grantwhen a provider's login had gone stale. Built-in providers whose catalog comes from pi.dev, such asopenai, no longer refresh their OAuth token for a catalog refresh at all. For providers that list models with the login, such as Radius and OpenRouter, a failed token refresh now prints a warning naming the provider andpi auth login <provider>, and the other catalogs still refresh; the command fails only for other errors, such as a network failureFixed the powershell tool reporting
Command exited with code 1under Windows PowerShell 5.1 when a native command succeeded but its stderr was redirected, as ingit push 2>&1 | Select-Object -Last 3. Windows PowerShell 5.1 turns that stderr into error records; such commands now report the exit code PowerShell 7 reportsFixed deleting a paste marker with Backspace corrupting later short markers such as
[paste #2], causing the marker text to be submitted instead of its pasted contentFixed dropped provider streams reported as "cut short after the reply had begun" not triggering automatic retries
Fixed the subagent extension example passing Bun's Windows virtual entry path as part of the prompt when spawning a compiled pi binary
Fixed the model selector and llama.cpp Hugging Face search moving the selection when a background catalog refresh or search result arrives
Fixed internal cursor markers leaking into terminal output, including with multiple markers or horizontally clipped content
Fixed the subagent extension example showing running tasks as completed, losing subprocess failure diagnostics, and failing to stop child processes on abort. Agent discovery and trust checks now use each task's working directory, and single and chain results are truncated without losing the full tool details
Fixed large pasted text being replaced by literal paste markers when switching editors, opening custom UI, or restoring queued messages
Fixed prompts and session-tree navigation overlapping during asynchronous input hooks, authentication, or branch summaries, which could install the wrong conversation context
Fixed Claude Sonnet 5 requests sending an unsupported temperature parameter
Fixed extensions loaded through symlinked paths failing to resolve their dependencies by resolving the entry file's real path before importing it
Fixed the plan-mode extension example missing completion markers in thinking blocks and common completion phrases, dropping formatted or long plan steps, and sending an extra model turn to acknowledge completion
Fixed OpenAI Responses requests sending
session_idinstead of the documentedsession-idaffinity headerFixed delivered image-only steering and follow-up messages remaining in the pending queue
Fixed cancellation during lazy provider loading or authentication being reported as an error instead of an abort
Fixed session runtime disposal tearing down extensions before active tools finished aborting and their results were recorded
Fixed the session-tree search cursor not being shown or positioned for input methods
Fixed SDK and RPC reloads replacing extensions while a response or compaction was still running; reload now asks the caller to wait
Fixed rendered edit diffs losing shared indentation when a change inserted text at the start of a line
Fixed
!and!!commands omitting the truncation notice and full-output file link when earlier output chunks had been discardedFixed extension selection dialogs growing beyond the terminal height; they now show a scrolling window of up to ten options
Fixed
pi configignoring custom keybindings fromkeybindings.jsonFixed concurrent OAuth refreshes through symlinked paths to the same
auth.jsonby sharing the lock on the resolved fileFixed provider connection errors hiding their underlying cause, such as connection refusal or certificate errors, behind generic messages
Fixed Ctrl+V not pasting clipboard images or text on Windows and WSL; both Ctrl+V and Alt+V are now default paste shortcuts there
Fixed llama.cpp connection errors omitting the server URL and underlying network error
Fixed Alacritty hyperlinks not being enabled when
TERM_PROGRAMis unset; detection now also usesTERMandALACRITTY_WINDOW_IDFixed OpenAI Codex SSE retries retaining abort listeners after each backoff, causing listener buildup on repeated retries
Azure OpenAI models now keep OpenAI's long-context price tier, so requests above 272K input tokens are costed at Azure's long-context rates
Fixed Anthropic and Bedrock sending
strict: "prefer"tools strict again on every request after Claude rejected them for exceeding its strict tool limits, which cost a rejected request (400) per turn. Later requests with the samesessionIdnow send those tools non-strict right away, untilcleanupSessionResources(sessionId)Fixed tool arguments for
Type.BigInt()andType.Undefined()parameters being rejected: they convert as TypeBox converted them ("42"and42to42n,nulltoundefined), now that pi-schema supports both types.Type.Void()still rejects every JSON argument.Fixed Azure GPT-6 Astra, Luna, Sol, GPT-6.1 Sol, and GPT-6.1 Terra using a 272K context window instead of the 1,050,000 tokens Azure Foundry deploys them with
Fixed OpenRouter rejecting requests with a 400 (
This endpoint's maximum context length is ...) for models whose output limit is close to the context window, such as DeepSeek flash. OpenRouter counts the input with its own tokenizer, which can be several percent higher than the provider's count, and pi left only 4,096 tokens spare. pi then treated the 400 as a context overflow and compacted the session, even at around 20% of the window. The default output limit now leaves 15% of the estimated input unused, and near a full window at most 32,768 output tokens are requestedFixed Anthropic non-strict tool schemas dropping root
$defsanddefinitions, which left property$refs pointing at nothing. Claude then produced wrong arguments for such tools (common in MCP servers), for example a JSON string instead of an object, and some Anthropic-compatible gateways rejected the request outrightFixed OpenCode Go Claude Haiku 5.5 failing with a 400 (
Invalid signature in thinking block ... bound to a different conversation) after the tool list, system prompt, or earlier history changed, which left the session failing on every retry. OpenCode Go and Zen Claude 5.5 models, Opus 5, and Fable 5.1 now use per-message effort and sendthinking.block_binding: drop_block, like the Anthropic providerFixed Markdown displaying HTML comments (
<!-- ... -->) as visible textFixed codemode
console.*output and thrown non-Error values printingNaN,Infinity, and-InfinityasnullFixed large MCP stdio messages being repeatedly copied and scanned as chunks arrived, causing slow tool responses
Fixed MCP Streamable HTTP SSE replies with CR-only line endings failing with "stream ended without a response"
Fixed oversized MCP SSE responses keeping their HTTP connections open after the message-size limit rejected them
Fixed MCP stdio server subprocesses surviving disconnect or pi exit on POSIX when the server's main process had already exited
Fixed MCP Streamable HTTP JSON replies bypassing message-size limits and HTTP errors buffering entire response bodies. Oversized replies and error-body content beyond the first 8 KiB are now cancelled
Fixed valid tool arguments being rejected when their schema combined local
$refs with a relative root$id, such asschemas/tool.jsonFixed the find tool starting an untracked
fdprocess when cancelled during its parent-directory lookup
1.5.0
2 Nov 2026- Breaking
Tool argument validation runs on
@earendil-works/pi-schema. TypeBox features outside JSON Schema (Type.Refine(),Type.BigInt(),Type.Undefined(), codecs,Format.Set()formats) no longer apply to tool arguments; see Tool parameter schemas and TypeBox. Plain JSON Schema tools, including MCP tools, now get the same coercion as TypeBox tools, such as converting numeric strings and wrapping a single value into an array. Validation failures the model sees list pi-schema's messages (- path: missing,- limit: expected number, got string) instead of TypeBox's (must have required properties path,must be number). - Security
Updated
undicito 8.12.3 and the Gondolin extension example to 0.14.0 for security advisories - Breaking
Removed the native OS
sandbox/extension example and its dependency. Use the Gondolin example or the containerization guide.
New Features
Extension update changelogs: see what changed in installed extension packages on the next fresh launch after an update. Package authors can choose the changelog path, and
collapseChangelogcondenses the notices. See Show a changelog.Faster streaming: large tool calls are parsed incrementally, and code-heavy answers and tool rows reuse highlighting and rendered Markdown instead of repeating the work on every update. See Keep rendering responsive.
Custom self-update commands: use
PI_SELF_UPDATE_COMMANDorselfUpdateCommandto update pi through a wrapper or another package manager. See Custom update command.GPT-6.1 Terra: available through OpenAI, Azure OpenAI Responses, and OpenAI Codex, with tool search, mid-conversation thinking-level changes, and thinking
off. Codex offers a 500K context window. See Models.
Breaking Changes
- Breaking
Tool argument validation runs on
@earendil-works/pi-schema. TypeBox features outside JSON Schema (Type.Refine(),Type.BigInt(),Type.Undefined(), codecs,Format.Set()formats) no longer apply to tool arguments; see Tool parameter schemas and TypeBox. Plain JSON Schema tools, including MCP tools, now get the same coercion as TypeBox tools, such as converting numeric strings and wrapping a single value into an array. Validation failures the model sees list pi-schema's messages (- path: missing,- limit: expected number, got string) instead of TypeBox's (must have required properties path,must be number).
Added
Extension packages can now show their changelog after an update. Pi reads
pi.changelogPathfrom the package'spackage.json, orCHANGELOG.mdin the package root, and on the next fresh launch shows entries newer than the last seen version under "Extension Updates". ThecollapseChangelogsetting condenses this to one line per package (#5958, #8790)pi.exec()accepts amaxBufferoption that limits stdout and stderr combined, and its result has atruncatedfield that is true when output exceeded the limitDevice-code login (for example GitHub Copilot) now opens the verification page and copies the code when you press Enter. Providers can turn either action off with
openBrowserOnConfirm: falseorcopyCodeOnConfirm: false(#9282, #9301)pi updatecan update Pi through a wrapper or another package manager. SetPI_SELF_UPDATE_COMMAND(for examplemise use -g npm:{packageName}@{version}) or the globalselfUpdateCommandsetting;pi updateruns it when pi.dev reports a newer release and fills{packageName},{version}, and{installSpec}from that release. See Custom update command (#7756, #5607)Extensions can format the user's configured keybindings with
keyText()andkeyHint()from the tool render context and the message and entry renderer options. Importing these functions from@earendil-works/pi-coding-agentcan resolve the extension's own copy of the package, which does not see pi's keybindings, so hints such askeyHint("app.tools.expand", "to expand")rendered without the key. The docs now recommend the injected functionsAdded persisted session-entry
messageIdand ISOtimestamptoMarkdownTransformContext. They are available when rendering saved entries and undefined for live renderingAdded a
blockedoption to inlinectx.ui.custom()components so approval prompts and other custom dialogs can report that pi is waiting for user input. Overlays ignore the option. See Custom screens and overlaysAdded
Usage.cost.totalFromProviderto distinguish billed totals from catalog estimates in SDK and extension usage data; combined usage is marked provider-reported only when every part isAdded concrete
responseModelmetadata to messages from pi-messages providers such as Radius, including when a virtual model is requested. See AssistantMessageAdded GPT-6.1 Terra for OpenAI, Azure OpenAI Responses, and OpenAI Codex, with tool search and mid-conversation thinking-level changes. It supports thinking
off; Codex offers a 500K context window
Changed
Extensions keep importing
Type,StaticandTSchemafrom@earendil-works/pi-ai: Pi maps that import to pi-ai's compat entry plus the TypeBox it bundles, now that pi-ai itself no longer re-exports TypeBox, and itsStringEnumthere stays a TypeBoxTUnsafe<T>. The built-in tool factories (createReadTool()and the others) returnTypeBoxAgentTool<typeof schema>, which keepsparamstyped for TypeBox.Tightened system prompt
pi updatefor installs from the pi.dev installer no longer passes--min-release-age=0tonpm ci. The release lockfile pins every package, so the flag had no effect, and security scanners that block it stopped the update/modeland/scoped-modelsnow show a model's name next to its ID when the name adds words the ID lacks, such as a renamedmodels.jsonoverride (#5916, #11347)MCP OAuth sign-in now uses pi's Client ID Metadata Document by default when the authorization server supports it for public clients, and registers a client dynamically otherwise, like Codex, Claude Code, and opencode. Clients registered before stay in use while their redirect URI matches. The new default
oauth.clientRegistration: "auto"registers whenclientNameor a non-defaultcallbackUrlis set;"dcr"always registers.pi mcp add --oauth-client-registrationsets the modeChanged the default OpenAI model from
gpt-5.5togpt-6.1-sol, including after ChatGPT sign-in when no model is selectedUpdated the built-in model catalog to models.dev v2. Realtime and image-only models are no longer offered as chat models; newer OpenAI and Google chat models are included
Fixed
Updated glob matching to prevent denial of service from amplified glob patterns.
Fixed a saved "Do not trust" decision being ignored for projects without trust-requiring resources, for example a folder with only
AGENTS.md. pi auto-trusted such projects, soctx.isProjectTrusted()returned true and package commands treated them as trusted. A saved decision intrust.jsonnow takes precedence; auto-trust applies only when no decision is savedFixed
Shift+Enterqueueing a follow-up instead of inserting a newline in Apple Terminal setups that sendESC+ Return. pi now checks the local Shift key state for that sequence, as it already did for plain Return;Alt+Enterwithout Shift still queues a follow-upFixed the working status (OSC 7501) disappearing in Rex and iTerm2 during runs in regular TUI mode. Rendered messages wrote OSC 133 prompt markers to the terminal, which the terminal treats as a new shell prompt; regular mode no longer writes them
Fixed compaction, branch summaries, and bug-report summaries in SDK sessions passing the stored OAuth token back to the model runtime as an explicit API key. Provider auth that treats explicit keys differently from stored OAuth now sees the OAuth login, as normal prompts do
Fixed a redundant system prompt update (tools, rules) when an extension set the same active tools in a different order, for example a reversed
pi.setActiveTools()list. Tools that stay active now keep their order and newly activated tools are appendedFixed
pi.exec()crashing pi withRangeError: Invalid string lengthwhen a command printed more output than fits in a string. The default output cap is the smaller of 256 MiB and the runtime string limit; past the cap, the command is terminated and the result hastruncated: trueand a nonzero exit codeFixed
pi.exec()never returning when a command ignored SIGTERM after a timeout or abort. pi now sends SIGKILL 5 seconds later, as intendedFixed
pi installandpi removeadding ever deeper nested entries to the npmpackage-lock.jsonwhen the agent directory is reached through a symlink, such as~/.pilinked into a dotfiles repo. pi now passes the resolved real path to npmMCP sign-in now rejects authorization endpoints and other OAuth metadata URLs that are not
http:orhttps:. Before, a malicious MCP server could supply afile:or custom protocol URL, which pi passed to the platform URL handler.Automatic
fdandrgdownloads no longer fetch x86-64 binaries on ARM32 and other architectures without a prebuilt release. pi now warns and recommends installing the tool with the system package managerFixed
/modelsearch ranking letters scattered over an earlier part of an entry above a real match, for exampleopuslistinggpt-oss-120bandclaude-sonnet-4.5beforeclaude-opus-4.1(#11220, #11296)Fixed
/resumesearch matching scattered letters anywhere in session messages and IDs, for example1024matching inside a session UUID. Session names and working directories still match fuzzily; IDs and message text now match only as exact substrings (#11220, #11024, #11296)Fixed HTML export showing a blank page for sessions with thousands of entries (#11225, #11293)
Fixed HTML export not showing system messages: the system prompt and tools, and later section updates such as after
/reload.pi --exportnow includes the system prompt and tools too (#11261, #3464, #11290)Fixed aborting a bash command on macOS sometimes running the next command of a list such as
long_step; next_step. pi now stops the process group before killing it (#11252, #11289)Fixed large streamed tool calls taking excessive CPU time and memory because every delta re-parsed the accumulated arguments. Providers and agent proxy streams now parse each delta once, grammar tools no longer copy their entire input per delta, and interactive tool renderers run at most once per frame
Fixed the login dialog opening sign-in URLs that are not web URLs, and printing control characters from sign-in, device-code, and info URLs, which could end a terminal hyperlink and send escape sequences to the terminal
Fixed
tui.select.pageUpandtui.select.pageDownbeing ignored in slash command and file autocomplete,/settings, and the model, scoped models, login, fork,/mcp, and llama.cpp selectors. In fullscreen mode, PageUp/PageDown now move an open list or autocomplete menu instead of scrolling the transcript, and a page key bound to Ctrl+V pages autocomplete instead of pasting an image (#7629, based on #7680Fixed tool output and
!command output showing the parameters of control sequences with a<,=or>prefix as text, for example35;59;1Mfrom a mouse reportESC[<35;59;1Mor0;276;0cfrom a terminal replyESC[>0;276;0c. Text after the keypad-mode sequencesESC=andESC>is still keptFixed
pi -e npm:<pkg>staying on the version from the first download. On each start and/reload, pi now reinstalls an-enpm package without an exact version when the registry has a newer matching version.pi -e git:<repo>@<branch>likewise stayed on its first checkout and is now fetched and reset to the branch; a commit-hash ref that is already checked out is not fetched. Offline mode and failed checks keep the cached copy (#11375, #11590)Fixed Windows paths being compared case-sensitively. When the working directory and home directory differed only in drive-letter casing (
c:\Users\mevsC:\Users\me), skills in~/.agents/skillsloaded twice, as project and user skills, and were reported as name collisions. The same mismatch also re-asked for saved project trust, hid sessions in a custom session directory from--continueand/resume, and stoppedpi removefrom matching configured local packagesFixed paths next to the home directory being shown with a broken
~prefix, for example/home/me2/projectshown as~2/projectwhen home is/home/meFixed
pi mcp login -landpi mcp logout -lfailing withUnknown option --local.althoughpi mcp addandpi mcp removeaccept-l. With-l, they now require the server to be a project server. Unknown options are now reported as typed, and a mistyped server name gets a suggestion, for exampleDid you mean "gurker"?Fixed
pi updatenaming pnpm for installs that only live underPNPM_HOME, for example a wrapper under$PNPM_HOME/global-nub/. pi said "not managed by a global pnpm install"; it now names the package manager only when that manager owns the installFixed image paste, copy, and opening the browser for sign-in failing silently on WSL when the working directory is deep. Windows programs such as
powershell.exeandexplorer.execannot start from a directory whose\\wsl.localhost\...path exceeds 260 characters; pi now starts these helpers from/Fixed the external editor failing silently, for example when the editor command is wrong or a Windows editor cannot start from a deep WSL directory. pi now shows a status message such as
External editor exited with code 1; prompt unchangedFixed
tool_searchand codemodesearchTools()ranking a tool below tools that only mention its name in their descriptions, for examplepeekaboo apprankingmcp__peekaboo__app14th. A tool matching more of the query's words now ranks above one matching fewer, a query word in a tool's name scores more than any number of mentions in its description, a tool whose whole name is in the query gets a large bonus, and long server instructions no longer lower the scores of that server's toolsFixed
tool_searchand codemodesearchTools()finding nothing for Chinese, Japanese, Thai, and other non-ASCII queries, because the tokenizer kept only ASCII letters and digits. Words in any script now match, text without spaces between words such as搜索记录is split into words, and canonically equivalent text such ascaféandcafe\u0301matches (#10816, #11037Fixed
pi updatestopping withgit clean -fdx failed with code 1on Windows when another pi session had a git extension's native module or executable open. Windows cannot delete such files, so the update left the new code with the old dependencies. pi now warns, installs the dependencies anyway, and retries the clean on the next updateFixed tool rows and streamed answers highlighting the same code again on every redraw. A running codemode row highlighted its whole script on every progress update and timer tick, a complete
writerow its whole file on every update and expand toggle, a streamedwriteits first 50 lines on every delta, and a streamed answer every earlier code block on every delta. Rows now reuse their last highlighting until the code, theme, or loaded grammars change, and assistant messages keep their rendered Markdown blocks while streamingFixed resized photos being sent as multi-megabyte PNGs even when JPEG was much smaller, causing large requests to fail or time out. Image resizing now tries the smaller encoding first
Fixed
pi update --extensionsreporting success without warning when npm's stale registry metadata left a package at its old version. pi now reports the installed and expected versionsFixed skill validation warnings being labeled
[Skill conflicts]even when there was no name collision. They are now shown under[Skill warnings]Fixed codemode tool descriptions including entire union and multi-line output types in every request. Object unions now summarize their fields and discriminators; other multi-line types point to
describeTool()for the full declarationFixed the model-scope startup notice being left in the shell after exiting fullscreen mode. It now appears inside pi's fullscreen header
Fixed startup from a deleted working directory crashing with an uncaught
uv_cwdstack trace. pi now asks the user to change to an existing directoryFixed failed session writes leaving entries in memory that were absent from disk, so later entries pointed to missing parents and resumed sessions lost earlier history and tools
Fixed
/treebranch summaries ignoring the session's thinking level, which could make reasoning models reject summary requests with an unsupportednoneeffortFixed hidden thinking with an empty hidden-thinking label still adding blank rows before answers and tool calls
Fixed package installation and removal printing npm audit and funding advice, including
npm audit fixinstructions that could install a second copy of pi into the package directoryFixed replacing an extension editor while a dialog was open hiding the dialog and leaving it unanswerable. The new editor now appears after the dialog closes
Fixed
grepcontext lines being offset from ripgrep's match line numbers when a file contains a lone carriage returnFixed
--model <provider>/<id>failing for provider IDs containing slashes, such as URL-derived llama.cpp provider IDsFixed slow session forking on filesystems where opening files is expensive by writing the fork through one file handle
Fixed
pi.exec()corrupting UTF-8 characters split across stdout or stderr chunksFixed
pi.exec()returning empty stderr when a command could not be spawned, such as a missing executable. It now preserves the spawn error messageFixed a configured package failing to install crashing startup. pi now skips the package, reports an extension warning, and retries on the next start or
/reload; explicit install and update commands still fail with a nonzero exitFixed the todo extension example crashing the TUI when a tool call failed argument validation
- Security
Updated
undicito 8.12.3 and the Gondolin extension example to 0.14.0 for security advisories Fixed OpenRouter cost totals using catalog estimates instead of reported billing for Chat Completions and Anthropic Messages. BYOK totals include both OpenRouter charges and reported upstream costs; component costs remain catalog estimates
Fixed OpenCode Zen and OpenCode Go requests using shared endpoints instead of their protocol-specific OpenAI, Anthropic, Google, and System One endpoints
Fixed Zhipu/Z.ai usage-limit errors (code
1308) being treated as transient HTTP 429 errors, causing automatic retries that cannot succeed until the usage cap resetsFixed LiteLLM's
ContextWindowExceededErrornot being recognized as context overflowFixed Gemini tool schemas sending unsupported
constkeywords. They are now converted to single-valueenumschemas without rewriting literal data in defaults, examples, or enum values, or losing properties named__proto__Fixed the faux provider counting simulated cache-write tokens as both input and cache writes
Fixed Orca terminals falling back to text for inline images. Orca is now recognized as supporting true color and hyperlinks, and Kitty images when it advertises
ORCA_IMAGE_PROTOCOL=kittyFixed bare Markdown URLs swallowing following CJK punctuation and text; explicit Markdown links and angle autolinks are unchanged
Fixed Kitty-protocol F1–F12 shortcuts, including modified function keys, not being recognized, and F13+ and other functional keys inserting invisible private-use characters into the editor (#11419, #11345)
Fixed Kitty images inside padded or colored boxes disappearing when their first row scrolled above the fullscreen viewport. Partially visible images are now cropped correctly, including beside other text
Fixed deeply nested Markdown blockquotes producing exponentially many lines, hanging or crashing rendering once their borders exhausted the available width
Fixed Claude sessions failing with
role 'system' must precede an 'assistant' messagewhen a system update was followed by an empty or reasoning-only assistant replyFixed Claude mid-conversation thinking-level changes failing with
Invalid effort levelon accounts whose organization caps effort belowhighFixed Kimi K3.1 Pro models using Kimi K2 request settings on Kimi Coding, Moonshot, and OpenCode Go. They now send the correct reasoning effort, preserve earlier thinking, accept tools added mid-conversation, and use K3-family pricing
Fixed OpenCode DeepSeek V4.1 Flash requests failing when long cache retention sent the unsupported
prompt_cache_retentionparameterFixed GPT-5.4 and GPT-5.5 failing with
Missing namespace for function_callafter switching from a model that had called toolsFixed Bedrock Claude requests failing when preferred strict tools exceed the provider's strict-tool limits. Requests now retry once with preferred tools non-strict while keeping required strict tools strict
Fixed OpenRouter's
~anthropic/claude-*-latestaliases losing earlier thinking after tool calls by using the Anthropic Messages APIFixed terminal titles containing control characters being able to inject terminal escape sequences, and pi-messages streams accepting invalid content-block indices
Fixed fullscreen double-click selection splitting paths and tokens at
~,.,\, and+; word characters now match iTerm2's defaultsFixed display math wider than the content area being split apart by line wrapping; it now falls back to raw LaTeX
Fixed styled words ending exactly at the wrap width adding a leading space on the next line, and strikethrough leaking into wrapped-line padding
Fixed
/treebranch summaries including failed assistant replies and original content that context edits had hidden or replaced. Summaries now honor the same context edits as live requests and compaction
Removed
- Breaking
Removed the native OS
sandbox/extension example and its dependency. Use the Gondolin example or the containerization guide.
Dependency tracking
Know when your own dependencies move
@earendil-works/pi-tui shipped a new major in the last 12 months, among 64 releases. inlinr shows which of your projects are behind, and what the upgrade breaks.
Advisories reach you
An email when a critical or high advisory affects a project, before the next install.
Upgrades checked first
Peer ranges, Node, ESM-only and types changes read before you bump.
Only what matters
Majors and breaking notes stay; patches and sibling bumps fold into one line.
Reading releases, release notes and advisories…
Registry facts last checked 19 Nov 2026. Releases and advisories last read 19 Nov 2026.
A whole project to check? Paste its package.json in the dependency check: every deprecated, outdated or vulnerable dependency, with what to upgrade to. Free, no account.