@earendil-works/pi-coding-agent
1.6.0 · 20 Nov 2026MIT6.6M / weekRepositoryHomepagenpmAtom feed
Upgrading @earendil-works/pi-coding-agent From 0.87.0 to 1.6.0
17 releases in betweenevery note read
Reading releases, release notes and advisories…
- 14
- changes to make
- 0
- advisories fixed
- 151
- new
- 369
- fixes
Start here
Before you upgrade
Tick each one off as you go- Breaking1.6.0
- Breaking1.6.0
- Breaking1.5.1
- Breaking1.5.1
- Breaking1.5.0
- Breaking1.5.0
- Breaking1.2.0
- Breaking1.2.0
- Breaking1.2.0
- Breaking1.2.0
Security
- 1.6.0
Updated
undicito 8.12.4 for security advisories GHSA-mqg3-3v4r-cm32, GHSA-7xg3-fphp-28hg, GHSA-5rm8-gv32-r954, GHSA-9v6h-8rgp-m69f, GHSA-3g9m-rv3r-w5w2, and GHSA-r4pc-4jcp-7pqc - 1.5.0
Updated
undicito 8.12.3 and the Gondolin extension example to 0.14.0 for security advisories - 1.0.1
Fixed installations resolving vulnerable
brace-expansion5.0.9 by pinningbrace-expansion5.0.12 as a direct dependency (GHSA-q2hr-2g5m-vwhr, GHSA-qhr7-859c-m2p7, GHSA-6j4f-fj2g-mc7p)
Release by release
- Security
Updated
undicito 8.12.4 for security advisories GHSA-mqg3-3v4r-cm32, GHSA-7xg3-fphp-28hg, GHSA-5rm8-gv32-r954, GHSA-9v6h-8rgp-m69f, GHSA-3g9m-rv3r-w5w2, and GHSA-r4pc-4jcp-7pqc - Breaking
Extension components:
render()now returnsreadonly string, andContainerreturns the same cached array while its children are unchanged. Extensions that modify render output in place, includingsuper.render()in aContainersubclass or an embedded component's output, must copy it first - Breaking
Removed the retired
deepseek-v3.2anddeepseek-v4-flashfrom the Qwen Token Plan Team providers; usedeepseek-v4-flash-0731ordeepseek-v4.1-flash - New
GPT-6.2 Astra and GPT-6.2 Sol: both models are available on the
openai,azure, andopenai-codexproviders, and GPT-6.2 Sol is now the default model for all three. See Providers.
- Security
- New
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.
- 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 removed - Fixed
Fixed Anthropic OAuth requests reporting an outdated Claude Code version
- New
- 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 - New
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
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.
- Breaking
- Security
Updated
undicito 8.12.3 and the Gondolin extension example to 0.14.0 for security advisories - 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). - Breaking
Removed the native OS
sandbox/extension example and its dependency. Use the Gondolin example or the containerization guide. - New
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.
- Security
- New
Image input for classifiers: codemode
models.classify()acceptsimagesfor TypeSafe's Jev and Cloudflare's Clef models ontypesafe,cloudflare-workers-ai, and OpenRouter. See Use classifier models and Codemode. - New
Models Configuration reference: every provider, model, model override, and compatibility field of
models.json, generated from its schema. See Models Configuration. - New
Summaries without a fixed output cap: compaction and branch summaries use the model's output limit, so long reasoning no longer makes them fail. See Compaction.
- New
Codemode waits for a free worker: parallel scripts and in-process subagents queue instead of failing, and
PI_CODEMODE_MAX_WORKERSraises the limit. See Codemode limits.
- New
- New
Choose where
/shareuploads:sessionShareDestinationselectsauto,gist, orradius. See Sessions and context and Export or share a session. - New
Cache-preserving thinking level changes on OpenAI GPT-6: changing the thinking level mid-session with an API key keeps the prompt cache.
- New
Kimi Code over Chat Completions: tools added mid-conversation no longer invalidate the prompt cache.
models.jsonbase URL overrides must now include/v1. See Providers. - New
Clean model switching: thinking from a previous model is dropped instead of being shown to the new model as text.
- New
- Breaking
Published generated configuration schemas for models, settings, keybindings, and themes at
https://pi.dev/schemas/*.schema.json. The theme schema moved tohttps://pi.dev/schemas/theme.schema.json; themes loaded during startup now receive the same schema validation as later reloads. Update theme$schemareferences, define reusable colors undervars, and remove unsupported metadata (#9880, #10751 - Breaking
Changed
before_agent_startto also fire for runs started bypi.sendMessage(..., { triggerTurn: true })while idle.BeforeAgentStartEventis now a union onmessageType:"user"events carrypromptandimages, and"custom"events carry the startingmessageand noprompt. Messages returned by handlers are added to both kinds of run, and pendingdeliverAs: "nextTurn"messages are delivered with the custom-message run. Handlers that should act only on user prompts must checkevent.messageType === "user"(#10267, #5581, #10739 - Breaking
Changed the session to count as busy while a run starts, including during
before_agent_starthandlers:ctx.isIdle()is false,pi.sendMessage()queues into the starting run instead of starting a second run that failed with "Agent is already processing",pi.sendUserMessage()requiresdeliverAs, and an abort requested meanwhile aborts the run once it starts - Breaking
Changed
pi mcp list --jsonto reportresources: truefor servers that offer resources instead ofresourcesandresourceTemplatescounts; Pi no longer lists resources when connecting
- Breaking
- New
Program status reporting: terminals and agent dashboards that support OSC 7501 see whether Pi is working, blocked on a dialog or login, done, or failed. See Program status.
- New
Claude Haiku 5.5:
anthropic/claude-haiku-5-5, with adaptive thinking up toxhigh/maxeffort. - New
Adjust default tools with
+name/-name:--toolsentries likepi -t +codemode,-writechange the default selection instead of replacing it. See Tools. - New
GPT-6 Luna and image classification: OpenAI's GPT-6 Luna is available as a classifier model through the Decisions API, and codemode's
models.classify()accepts images for classifiers that support them. See Use classifier models.
- New
63 other lines we could not sort, mostly version bumps
- 1.6.0
Qwen Token Plan providers now use the current gateways (
token-plan.maas.qwencloudapi.cominternational,token-plan.maas.qianwenaiapi.comChina), andqwen-token-planandqwen-token-plan-cnare named "Qwen Token Plan Team" and "Qwen Token Plan Team CN". Provider IDs are unchanged, and the oldaliyuncs.comhosts still work - 1.6.0
The default model for the
openai,azure, andopenai-codexproviders is now GPT-6.2 Sol (gpt-6.2-sol) instead of GPT-6.1 Sol, at the same price - 1.6.0
The find tool's path patterns are now relative to the search directory, like grep's
glob:src/*.tsfindssrc/a.tsbut no longerpkg/src/a.ts; use**/src/*.tsto match at any depth. Patterns without/still match file names at any depth - 1.6.0
The llama.cpp extension now connects to
http://127.0.0.1:9931by default, the current llama-server default port, instead of port 8080 - 1.6.0
Anthropic message threads are now on by default for any provider whose baseUrl is on api.anthropic.com, not only the
anthropicprovider - 1.6.0
The resume command printed on exit is now on its own line after
To resume this session:, so it can be selected with a triple-click - 1.5.2
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 - 1.5.1
The default model for the
anthropicprovider is now Claude Opus 5.5 (claude-opus-5-5) instead of Claude Opus 4.8 - 1.5.1
Default 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-gateway - 1.5.1
cacheWarmingnow 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 behavior
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.