@earendil-works/pi-tui
1.5.2 · 10 Nov 2026MIT9.8M / weekRepositoryHomepagenpmAtom feed
1.5.2 is the newest release of 1.x.
In short
2 breaking2 removed3 security5 new2 faster13 fixed
- 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- - Breaking
Changed the default OpenAI model from
gpt-5.5togpt-6.1-sol, including after ChatGPT sign-in when no model is selected - Removed
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. - Removed
Updated 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
- Security
Updated glob matching to prevent denial of service from amplified glob patterns.
- Security
Updated
undicito 8.12.3 and the Gondolin extension example to 0.14.0 for security advisories - Security
Fixed terminal titles containing control characters being able to inject terminal escape sequences, and pi-messages streams accepting invalid content-block indices
Release note
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.
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.