@earendil-works/pi-tui
1.5.2 · 10 Nov 2026MIT9.8M / weekRepositoryHomepagenpmAtom feed
Upgrading @earendil-works/pi-tui From 0.84.2 to 0.99.2
11 releases in betweenevery note read
Reading releases, release notes and advisories…
- 10
- changes to make
- 0
- advisories fixed
- 101
- new
- 185
- fixes
Start here
Before you upgrade
Tick each one off as you go- Breaking0.87.0
- Breaking0.87.0
- Breaking0.87.0
- Breaking0.87.0
- Breaking0.87.0
- Breaking0.86.0
- Breaking0.86.0
- Breaking0.86.0
- Breaking0.86.0
- Breaking0.84.3
Release by release
- New
MCP servers stay out of the way: servers with the default
codemodeexposure are no longer listed in thecodemodedescription and no longer block the first prompt. They appear in a short system prompt section, and scripts find their tools withsearchTools()anddescribeNamespace(). See Control tool exposure. - New
More MCP authentication options:
oauth.clientNamefor servers that only accept known OAuth clients, and"auth": { "provider": "<provider>" }to authenticate HTTP servers with a provider's/logintoken. See Authenticate with OAuth. - New
Anthropic workload identity federation from the Anthropic SDK environment variables. See Use an API key from the environment.
- New
/reloadenables tools newly added to thedefaultToolssetting. See Tools.
- New
- New
GPT-6.1 Sol — Available on OpenAI, Azure OpenAI, and OpenAI Codex, and now the default OpenAI Codex model. See Select a model.
- New
Added GPT-6.1 Sol (
gpt-6.1-sol) to the OpenAI, Azure OpenAI Responses, and OpenAI Codex providers. - Fixed
Fixed
/loginwith OpenAI failing in the bundled release with a missingopenai-chatgpt.jsmodule error.
- New
- New
Codemode and MCP — Connect MCP servers and let models run JavaScript that calls tools in parallel. See MCP Servers and Enable codemode.
- New
System theme — Pi's colors now come from your terminal's own palette by default. See Use your terminal's colors.
- New
Sign in with ChatGPT — Use a ChatGPT subscription with the OpenAI provider through
/login openai. See Authenticate interactively. - New
Virtual models — Extensions can route each request to a different physical model. See Virtual Models.
- New
- New
Latest frontier models — Use Claude Opus 5.5, GPT-6 Sol, and GPT-6 Luna through supported providers, including GitHub Copilot. See Choose a Model.
- New
Grok 4.7 by default for xAI — New xAI sessions now default to Grok 4.7. See Provider Authentication.
- New
Added inherited Claude Opus 5.5, GPT-6 Sol, and GPT-6 Luna support for GitHub Copilot.
- New
Added inherited GPT-6 Sol and GPT-6 Luna support for OpenAI API keys and OpenAI Codex subscriptions.
- New
- Breaking
Removed the inherited
shouldStopAfterTurnagent option. UsefinishTurnand return{ action: "end" }instead.finishTurnruns beforeturn_endbut applies the decision afterward, and it also receives error and aborted responses; migrate normal-response predicates by returningundefinedfor those hard exits. See the@earendil-works/pi-agent-corechangelog for a complete before-and-after example. - Breaking
Added
ContextEditEntryto the exportedSessionEntryunion. TypeScript consumers with exhaustive entry switches must handlecontext_edit; usereplacement: nullfor omission and a content replacement otherwise. - Breaking
Made
SessionManagercanonical forAgentSessionprovider context. Assigningsession.agent.state.messagesno longer replaces future request history; restore withSessionManager.inMemory(cwd, { id }, entries), navigate withsession.navigateTree(), or append throughsession.sessionManagerand callsession.refreshContext(). - Breaking
Expanded
TurnEndEventwith required boundary fields and addedAgentBeforeSettleEventto the exportedExtensionEventunion. Consumers constructing events or exhaustively switching onExtensionEventmust handle the new shapes.ExtensionRunner.emit()no longer acceptsturn_end; host integrations dispatch actionable boundaries withemitBoundary(baseEvent, buildContext).
- Breaking
- New
Meta Muse provider — Sign in with Meta using
/login metaor useMETA_API_KEYto access Muse Spark models. See Meta (Muse subscription). - New
Added Meta (Muse subscription) login via
/login metawith automatic Model API key refresh, plusMETA_API_KEYsupport - Fixed
Fixed
/bugdescriptions dropping line breaks from pasted diagnostics. - Fixed
Fixed
/bughints appearing for user cancellations and retryable provider failures such as service unavailability. - Fixed
Fixed clipboard copy failing in containers and WSL without WSLg by restoring the OSC 52 fallback when no display is available, and added a verified Windows clipboard backend for WSL (#9688).
- Fixed
Fixed inherited z.ai
Prompt too longerrors not being recognized as context overflow (#9805). - Fixed
Fixed inherited Cerebras models advertising unsupported strict tool schemas, which caused HTTP 400 errors when strict and non-strict tools were mixed
- New
- Breaking
Changed inherited pi-ai provider stream inputs from
Contextto normalizedTranscriptContextvalues. Custom providers must read system prompts and tool declarations fromcontext.messageswithgetCurrentSystemPrompt()andgetCurrentTools(). See Custom Streaming API. - Breaking
Restricted inherited
ToolCall.argumentsandToolResultMessage.detailsto JSON-compatible values, changedToolResultMessageinto a conditional type, and madeJsonValuearrays readonly. - Breaking
user_bashnow fails closed: errors or invalid defined results abort the command without invoking later handlers or executing locally. Returnundefinedto continue propagation; otherwise return{ operations }or{ result }(#9068). - Breaking
Removed unavailable inherited GPT-5.4 and GPT-5.4 mini models from OpenAI Codex selection (#9394).
- Breaking
- New
GPT-6 Astra — Available through OpenAI API keys and OpenAI Codex subscriptions. See API Keys and OpenAI Codex.
- New
Added GPT-6 Astra for OpenAI API keys and OpenAI Codex subscriptions.
- New
Added five-times-faster mouse wheel scrolling while holding Alt in fullscreen mode
- Fixed
Fixed configurable save keybindings in the model and thinking selectors
- Fixed
Fixed SDK import failures caused by unintentionally publishing internal experimental code and dependencies in 0.85.0. The experimental
clientandexperimental/pluginsubpaths and server/client commands are now source-only throughpi-test.sh; the supported local SDK and stdio RPC API are unchanged (#9132). - Fixed
Fixed mouse hover changing selection and recentering autocomplete and settings lists, causing clicks to target a different item.
- Fixed
Fixed long prompt-cache requests for GPT-5.6+ Responses models to use
prompt_cache_options.ttl: "30m"instead ofprompt_cache_retention: "24h".
- New
35 other lines we could not sort, mostly version bumps
- 0.99.2
MCP servers with the default
codemodeexposure no longer appear in thecodemodedescription; scripts find them withsearchTools().codemode-deferredis now an alias forcodemode. Usedirectexposure for tools the model should see without searching (#10212). - 0.99.1
Changed the default OpenAI Codex model to GPT-6.1 Sol (
gpt-6.1-sol). - 0.99.0
Switched the build from the TypeScript native preview to TypeScript 7.0 with an ES2024 target, and replaced
tsxwith Node's built-in type stripping for running from source (#9965). - 0.99.0
Removed the
[Themes]section from the startup banner. Custom themes remain available in/settings, and theme conflicts are still reported. - 0.99.0
Changed the startup header to show the pi logo with the version instead of the app name.
- 0.99.0
Changed the built-in
darkandlightthemes to the revised pi colors, written in OKHSL. - 0.99.0
Changed light/dark terminal detection to use the reported background color first, then the terminal's light/dark report, then
COLORFGBG. The first-time setup no longer shows the detected appearance. - 0.99.0
Renamed the inherited OpenAI Codex provider to "OpenAI Codex (legacy)"; Sign in with ChatGPT on the OpenAI provider supersedes it.
- 0.99.0
Changed inherited terminal detection to treat
TERM=*-directas truecolor. - 0.99.0
Built-in extensions and tools are named
builtin:<name>(for examplebuiltin:mcpandbuiltin:read) in errors, diagnostics, RPC source info, and bug reports, instead of<inline:name>and<builtin:name>. Their slash commands no longer carry a[t]autocomplete tag.
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.