No entries match these filters. Clear filters
Pi v0.99.2 adds MCP MCP Model Context Protocol, a standard for connecting AI applications to external tools and data sources. A compatible server exposes capabilities an assistant can use through a common interface. tool discovery helpers, OAuth client naming, Anthropic federation, and live tool reloading.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.99.2 https://github.com/earendil-works/pi.git
$ git checkout v0.99.2
describeNamespace() and searchTools() codemode functions to discover MCP tools by namespace without direct exposure Not checked yet -d / --description flag on pi mcp add to set an MCP server description for ranking in tool search Not checked yet --oauth-client-name flag on pi mcp add (maps to oauth.clientName) to name the OAuth client for restrictive servers Not checked yet "auth": { "provider": "<name>" } config key for HTTP MCP servers to use a /login bearer token bearer token A credential that grants access to whoever presents it, without a separate proof of possession. Protecting the token matters because a stolen copy can be used by someone else. instead of MCP OAuth MCP OAuth An authentication layer for the Model Context Protocol that lets MCP clients obtain delegated access tokens so cyber tools can call MCP servers on a user's behalf without handling raw credentials. Not checked yet Support for Anthropic workload identity federation workload identity federation A mechanism that lets a workload running in one cloud or platform prove its identity to another service using a trusted token exchange, eliminating the need to store long-lived credentials or secrets. via ANTHROPIC_FEDERATION_RULE_ID, ANTHROPIC_ORGANIZATION_ID, and ANTHROPIC_IDENTITY_TOKEN_FILE env vars Not checked yet
+1 more
show less
/reload command to enable tools newly added to the defaultTools setting without restart Not checked yet
6 details in Everything
Pi v0.99.0 adds MCP MCP Model Context Protocol, a standard for connecting AI applications to external tools and data sources. A compatible server exposes capabilities an assistant can use through a common interface. server support, virtual models, classifier models, and codemode tool execution.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.99.0 https://github.com/earendil-works/pi.git
$ git checkout v0.99.0
└──▷ USE IT
Register a virtual model programmatically to route requests based on input content.
js
copy
pi.registerVirtualModel('my-router', (req) => req.type === 'code' ? 'claude-sonnet' : 'gpt-4o');
Adds mcp.json config path and /mcp add|remove|list|login|logout CLI commands for managing Model Context Protocol Model Context Protocol Model Context Protocol, a standard for connecting AI applications to external tools and data sources. A compatible server exposes capabilities an assistant can use through a common interface. servers Not checked yet Adds pi.registerVirtualModel() API and /session cost reporting to route requests to different physical models Not checked yet Adds classifier model support via classify() in ModelRuntime, Jev classifiers from codemode scripts, and inherited classifiers on OpenRouter OpenRouter A unified API gateway that routes requests to dozens of LLM providers under one endpoint, letting cyber tools swap or compare models without rewriting provider-specific integration code. , Cloudflare Workers AI, Vercel AI Gateway, and OpenCode Zen Not checked yet Adds codemode.mode and codemode.inlineBudget config keys and --tools/defaultTools (with +name/-name) to enable and configure the codemode JavaScript sandbox Not checked yet Adds types=chat,image,classifier parameter for pi.dev model catalog requests to overlay supported model types during remote refreshes Not checked yet
5 details in Everything
└──▷ BREAKING ON UPGRADE
! Built-in extensions and tools are now named builtin:<name> (e.g., builtin:mcp) in errors, diagnostics, RPC RPC Remote Procedure Call, a protocol that lets a program execute a function on another machine as if it were local, giving cyber tools a structured way to communicate across processes or hosts without managing raw sockets. source info, and bug reports instead of <inline:name> or <builtin:name>"! Slash commands for built-in extensions no longer carry a [t] autocomplete tag! --no-extensions now also disables the built-in extensions; load one explicitly with -e builtin:<name>
Pi v0.87.1 adds support for Claude Opus 5.5, GPT-6 Sol/Luna and defaults xAI to Grok 4.7
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.87.1 https://github.com/earendil-works/pi.git
$ git checkout v0.87.1
Pi v0.87.0 adds context_with_system extension, per-model image resize limits, and session context edit APIs.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.87.0 https://github.com/earendil-works/pi.git
$ git checkout v0.87.0
sessionManager.appendContextEdit(entryId, null) appends an append-only model-context edit to omit messages from future provider context without changing raw history. Not checked yet turn_end and agent_before_settle are new actionable extension boundaries that allow returning { entries: [...event.entries, draft], continue: true } to persist structural entries. Not checked yet inputLimits.images.resize in models.json configures cache-safe image resize profiles per model for attachments and tool-result images. Not checked yet Added context_with_system extension event for per-request system-message transformations on the full transcript. Not checked yet
4 details in Everything
└──▷ BREAKING ON UPGRADE
! Removed the inherited shouldStopAfterTurn agent option; use finishTurn and return { action: "end" } instead.! Expanded SessionEntry union to include ContextEditEntry; TypeScript consumers with exhaustive entry switches must handle context_edit.! Made SessionManager canonical for AgentSession provider context; assigning session.agent.state.messages no longer replaces future request history.! Expanded TurnEndEvent with required boundary fields and added AgentBeforeSettleEvent to the exported ExtensionEvent union.
Adds META_API_KEY env var and /login meta CLI subcommand to connect Pi to Meta (Muse) models.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.86.1 https://github.com/earendil-works/pi.git
$ git checkout v0.86.1
└──▷ USE IT
Use the new environment variable to authenticate Pi with a Meta Muse subscription programmatically in CI or scripts.
shell
copy
META_API_KEY=your_key_here pi -c 'analyze this code'
Start an interactive authentication flow with the Meta provider from within the Pi CLI.
shell
copy
pi /login meta
Adds META_API_KEY environment variable to configure the Meta API key for Muse Spark models Not checked yet Adds /login meta command-line subcommand to initiate Meta authentication with automatic Model API key refresh Not checked yet
2 details in Everything
Pi v0.86.0 adds /bug CLI command, cache warming, per-model compaction budgets, and offline Radius catalog
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.86.0 https://github.com/earendil-works/pi.git
$ git checkout v0.86.0
└──▷ TRY IT
Generate a bug report with the current session transcript attached.
copy
$ /bug encountered an unexpected error in tool execution
Configure per-model token budgets for compaction in the config file.
yaml
copy
compaction:
modelOverrides:
anthropic/claude-3-opus:
reserveTokens: 5000
keepRecentTokens: 2000
Call a model via the extension API with resolved authentication.
typescript
copy
const result = await ctx.modelRegistry.streamSimple({
provider: 'anthropic',
model: 'claude-3-opus-20240229',
messages: [
{ role: 'user', content: 'Hello' }
]
});
/bug subcommand to report issues with redacted diagnostics, optional transcript export, or ZIP archive upload. Not checked yet Cost-aware prompt cache warming during long tool runs and while idle via cache_warming_decision extension event and configurable modes. Not checked yet Per-model compaction budgets using reserveTokens and keepRecentTokens in compaction.modelOverrides config key. Not checked yet Offline Radius model catalog for immediate model selection with cached/live overlay support. Not checked yet compat.allowedFallbackModels configuration to override or disable Anthropic server-side fallback models. Not checked yet
+1 more
show less
ctx.modelRegistry.stream() and streamSimple() extension APIs for model calls through configured providers. Not checked yet
6 details in Everything
└──▷ BREAKING ON UPGRADE
! Inherited pi-ai provider stream inputs changed from Context to normalized TranscriptContext; custom providers must read system prompts and tool declarations from context.messages using getCurrentSystemPrompt() and getCurrentTools() .! ToolCall.arguments and ToolResultMessage.details restricted to JSON-compatible values; ToolResultMessage is now a conditional type and JsonValue arrays are readonly.! user_bash fails closed on errors or invalid defined results, aborting without invoking later handlers or executing locally (return undefined to continue propagation).
Pi v0.85.1 adds GPT-6 Astra support for OpenAI Codex subscribers and fixes SDK publishing issues.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.85.1 https://github.com/earendil-works/pi.git
$ git checkout v0.85.1
Adds GPT-6 Astra model support via the OpenAI API and OpenAI Codex subscriptions, documented in packages/coding-agent/docs/providers.md Not checked yet Improves mouse wheel scrolling speed by five times when holding Alt in fullscreen mode Not checked yet
2 details in Everything
Pi v0.85.0 adds persistent Claude thinking effort, fullscreen transcript controls, SDK session restoration, and vLLM/OpenAI model settings
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.85.0 https://github.com/earendil-works/pi.git
$ git checkout v0.85.0
Adds tui.altScreen.bottom keybinding to jump to the latest message in a fullscreen scrolled transcript Not checked yet Adds inherited OpenAI-compatible vllmPriority model setting for vLLM scheduler priority configuration Not checked yet Adds inherited OpenAI-compatible supportsMaxOutputTokens model setting for OpenAI Responses output-token limits Not checked yet Adds SessionManager.inMemory() SDK method for restoring externally managed session entries Not checked yet
4 details in Everything
Pi v0.84.4 adds terminal capability overrides, RPC RPC Remote Procedure Call, a protocol that lets a program execute a function on another machine as if it were local, giving cyber tools a structured way to communicate across processes or hosts without managing raw sockets. clear_queue, and DeepSeek V4 Flash Vision support.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.84.4 https://github.com/earendil-works/pi.git
$ git checkout v0.84.4
└──▷ USE IT
Programmatically detect the MIME type of an image file using the new public API
code
copy
const { detectSupportedImageMimeTypeFromFile } = require('pi-coding-agent');
const mime = await detectSupportedImageMimeTypeFromFile('/path/to/image.png');
console.log(mime); // e.g., 'image/png'
Clear any pending steering or follow-up messages in the RPC queue
code
copy
const response = await rpc.call('clear_queue');
console.log(response); // Contains retrieved and cleared messages
Adds detectSupportedImageMimeTypeFromFile() to the public library exports for detecting image MIME types from files Not checked yet Adds RPC method clear_queue to retrieve and clear queued steering and follow-up messages Not checked yet Adds deepseek-v4-flash-vision-exp as a supported vision-capable model through the built-in provider Not checked yet Adds fullscreenCopyOnSelect setting and related environment variables to control fullscreen selection copy behavior Not checked yet Adds ui_prompt_start and ui_prompt_end extension events to distinguish active agent work from waiting on user prompts Not checked yet
5 details in Everything
Pi v0.84.3 adds PowerShell tool execution on Windows, safer atomic updates, and thinking level controls.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.84.3 https://github.com/earendil-works/pi.git
$ git checkout v0.84.3
└──▷ USE IT
Configure Pi to execute Windows commands via PowerShell.
config
copy
"defaultTools": [
"browser",
"search",
"text_editor",
"file_read",
"file_write",
"powershell"
]
Adds optional native powershell tool for Windows command execution, configurable via defaultTools in config or SDK. Not checked yet Changes pi update to stage, verify, and atomically activate releases for installer-managed installations. Not checked yet Adds /thinking selector with searchable defaults and Ctrl+S keybinding to persist selected thinking levels session-scoped or globally. Not checked yet
3 details in Everything
└──▷ BREAKING ON UPGRADE
! Renamed the inherited GoogleThinkingLevel type to GoogleApiThinkingLevel and added ResolvedGoogleThinkingLevel for normalized adapter levels.
Pi SDK gains configurable model catalog caching with offline mode, custom store paths, and forced refresh support.
└──▷ USE IT
Refresh the model catalog at startup with a 15-second timeout — useful in CI or containerized environments where stale catalogs would cause failures.
javascript
copy
const refreshedRuntime = await ModelRuntime.create({
allowModelNetwork: true,
modelRefreshTimeoutMs: 15_000
});
Force an immediate catalog refresh mid-session, bypassing the four-hour throttle — useful after a provider publishes a new model you need right away.
javascript
copy
await modelRuntime.refresh({ allowNetwork: true, force: true, signal });
Adds allowModelNetwork and modelRefreshTimeoutMs options to ModelRuntime.create() to opt in to a network refresh of the model catalog at creation time and bound how long it may take. Not checked yet Adds modelsStorePath config option to ModelRuntime.create() to specify a custom path for the local model catalog store. Not checked yet Adds modelsStore injection point to ModelRuntime.create() to supply a custom persistence implementation for the model catalog. Not checked yet Adds modelRuntime.refresh({ allowNetwork: true, force: true, signal }) method to force an immediate catalog refresh, bypassing the default four-hour per-provider throttle. Not checked yet Adds PI_OFFLINE environment variable to disable all model network access. Not checked yet
5 details in Everything
Pi CLI gains --use-theme flag for per-run theme selection and adds optional search-highlight color tokens to theme definitions.
└──▷ TRY IT
Start a single session with the light theme without overwriting your saved theme preference.
copy
$ pi --use-theme light
Follow the terminal's light/dark appearance for one run without changing the saved setting.
copy
$ pi --use-theme light/dark
Add search-match highlight colors to a custom theme; omit these tokens to use the built-in fallbacks.
json
copy
"searchMatchBg": "#2d2d30",
"searchMatchText": ""
Adds --use-theme flag to start an interactive run with a specific theme without changing the saved setting (e.g. pi --use-theme light). Not checked yet Supports light/dark syntax with --use-theme (e.g. pi --use-theme light/dark) to follow terminal appearance for that run. Not checked yet Adds optional searchMatchBg and searchMatchText color tokens to theme definitions for transcript search-match highlight colors, with documented fallback behavior. Not checked yet
3 details in Everything
Pi adds fullscreenExitOutput, defaultTools config key, and new CLI tool-filtering flags.
└──▷ USE IT
Start Pi with only bash and edit available at launch, keeping any extension tools active — useful for restricting the default toolset in a project.
json
copy
{"defaultTools": ["bash", "edit"]}
Adds fullscreenExitOutput config setting with values "transcript" (prints final transcript and resume hint) and "resume-hint" (restores previous screen and prints only the resume hint); has no effect in regular TUI TUI A text-based user interface that runs inside a terminal, using characters and ANSI escape codes to render menus, panes, and widgets without a graphical desktop, letting cyber tools ship rich interactivity with no GUI dependency. mode. Not checked yet Adds defaultTools config key to select which built-in tools are enabled at startup; extension and SDK custom tools remain enabled regardless. Accepts an array such as ["bash", "edit", "write"]; an empty array starts with no built-in tools while preserving extension and SDK custom tools. Not checked yet Adds --tools CLI flag as a strict allowlist for all tools, replacing defaultTools behavior. Not checked yet Adds --no-tools CLI flag to disable all tools. Not checked yet Adds --no-builtin-tools CLI flag to disable built-in defaults only. Not checked yet
+2 more
show less
Adds --exclude-tools CLI flag to filter the resulting tool list after other tool flags are applied. Not checked yet Documents that Windows paths in JSON config (e.g. shellPath) must use forward slashes (C:/Program Files/Git/bin/bash.exe) or escaped backslashes (C:\\Program Files\\Git\\bin\\bash.exe). Not checked yet
7 details in Everything
Pi CLI gains --use-theme flag for per-run theme selection and fullscreen exit output control.
└──▷ TRY IT
Apply a specific theme for a single Pi session without overwriting your saved theme preference.
copy
$ pi --use-theme dark/compact
Adds --use-theme <name[/name]> flag to set the interactive theme for a single run without changing saved settings. Not checked yet New fullscreen exit output control determines whether exiting fullscreen prints the final transcript or restores the previous screen and prints only the session resume hint. Not checked yet
2 details in Everything
Pi 0.84.2 adds fullscreen transcript search, configurable default tools, strict JSON-schema sampling, and new extension APIs.
└──▷ TRY IT
Lock in a specific visual theme for a single interactive session without overwriting your saved preferences.
copy
$ pi --use-theme dracula interactive
Enable strict JSON-schema constrained sampling for the built-in read/bash/edit/write tools to get schema-conformant outputs during experimentation.
copy
$ PI_EXPERIMENTAL=1 pi interactive
Set the default built-in tool selection for all projects globally so every new session starts with only the tools you want.
json
copy
{
"defaultTools": ["read", "bash"]
}
Adds defaultTools setting for configuring the initial built-in tool selection globally or per project. Not checked yet Adds --use-theme <name[/name]> CLI flag to choose an interactive theme per-run without changing saved settings. Not checked yet Adds expandPromptTemplates option to the extension pi.sendUserMessage() API for explicitly dispatching commands and expanding skills and prompt templates. Not checked yet Adds createGatewayBindingFetch() for routing Cloudflare AI Gateway requests through a Workers AI binding without an API token. Not checked yet Adds AssistantMessage.endTurn field to preserve OpenAI Codex's terminal end_turn signal for diagnostics. Not checked yet
+4 more
show less
Adds fullscreen transcript search via Ctrl+Shift+F with incremental match highlighting and next/previous navigation via Enter , Ctrl+G , and Ctrl+Shift+G . Not checked yet Adds experimental strict JSON-schema constrained sampling for the default read, bash, edit, and write tools under PI_EXPERIMENTAL=1. Not checked yet Adds a fullscreen exit output setting to choose between printing the final transcript and printing only a session resume hint. Not checked yet Adds inherited unbound single-line transcript scrolling actions for fullscreen mode. Not checked yet
9 details in Everything
Pi v0.84.2 adds fullscreen transcript search, configurable default tools, a per-run theme flag, and new extension/gateway APIs.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.84.2 https://github.com/earendil-works/pi.git
$ git checkout v0.84.2
└──▷ TRY IT
Apply a one-off theme for a single session without permanently changing your saved theme preference.
copy
$ pi --use-theme dracula
Enable experimental strict JSON-schema constrained sampling for built-in tools to improve structured output structured output Forcing a model's response to match a given format or JSON schema, so software can parse it reliably instead of hoping the text is well formed. reliability.
copy
$ PI_EXPERIMENTAL=1 pi
Adds --use-theme <name[/name]> flag to choose an interactive theme for a single run without overwriting saved settings. Not checked yet Adds defaultTools setting for configuring the initial built-in tool selection globally or per project. Not checked yet Adds expandPromptTemplates option to the extension pi.sendUserMessage() API for explicitly dispatching commands and expanding skills and prompt templates. Not checked yet Adds createGatewayBindingFetch() for routing Cloudflare AI Gateway requests through a Workers AI binding without an API token. Not checked yet Adds AssistantMessage.endTurn to preserve OpenAI Codex's terminal end_turn signal for diagnostics. Not checked yet
+6 more
show less
Adds PI_EXPERIMENTAL=1 to enable experimental strict JSON-schema constrained sampling for the default read, bash, edit, and write tools. Not checked yet Adds PI_TUI_ESC_TIMEOUT environment variable to tune Escape-key detection latency for high-latency terminals (e.g. over SSH). Not checked yet Adds fullscreen transcript search via Ctrl+Shift+F with incremental match highlighting, configurable search match theme colors, and next/previous navigation with Enter /Ctrl+G and Shift+Enter /Ctrl+Shift+G . Not checked yet Adds a fullscreen exit output setting to choose between printing the full final transcript or only a session resume hint. Not checked yet Adds unbound single-line transcript scrolling actions for fullscreen mode. Not checked yet Documents the AI_AGENT=pi process marker and how it differs from PI_CODING_AGENT=true. Not checked yet
11 details in Everything
Pi 0.84.1 adds Qwen Token Plan Individual provider, pi auth check preflight, extension terminate support, and fullscreen selection improvements.
└──▷ TRY IT
Verify that a provider or model's credentials are correctly configured before running a session.
Adds QWEN_TOKEN_PLAN_API_KEY environment variable and Qwen Token Plan Individual as a built-in provider with its documented subscription model catalog. Not checked yet New pi auth check command runs provider/model auth preflight and optionally emits the resolved credential. Not checked yet Adds terminate support to blocked extension tool_call events, allowing all-terminating batches to skip the automatic follow-up model call. Not checked yet Adds double-click word selection, granularity-aware drag selection, and triple-click paragraph selection in fullscreen mode. Not checked yet Adds unbound half-page transcript scrolling actions for fullscreen mode. Not checked yet
5 details in Everything
Pi v0.84.1 adds pi auth check for credential preflight, Qwen Token Plan Individual provider, and terminate support for blocked extension tool_call events.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.84.1 https://github.com/earendil-works/pi.git
$ git checkout v0.84.1
└──▷ TRY IT
Verify that your configured provider credentials are valid before starting a long agent run.
Adds pi auth check subcommand to verify provider or model credentials before a run, with optional resolved credential output. Not checked yet Adds QWEN_TOKEN_PLAN_API_KEY environment variable and Qwen Token Plan Individual as a built-in provider with its subscription model catalog. Not checked yet Adds terminate support to blocked extension tool_call event handlers, allowing all-terminating batches to skip the automatic follow-up model call. Not checked yet Adds double-click word selection, granularity-aware drag selection, and triple-click paragraph selection in TUI TUI A text-based user interface that runs inside a terminal, using characters and ANSI escape codes to render menus, panes, and widgets without a graphical desktop, letting cyber tools ship rich interactivity with no GUI dependency. fullscreen mode. Not checked yet Adds unbound half-page transcript scrolling actions for TUI fullscreen mode, configurable via keybindings. Not checked yet
5 details in Everything
Pi SDK adds setRuntimeApiKey() , removeRuntimeApiKey() , refresh() with abort signals, and CredentialSynchronizationError for provider credential lifecycle management.
└──▷ USE IT
Set a runtime API key for a provider and handle synchronization failures without retrying the credential mutation blindly.
javascript
copy
try {
await modelRuntime.setRuntimeApiKey("anthropic", process.env.MY_KEY);
} catch (err) {
if (err instanceof CredentialSynchronizationError) {
console.error(`Sync failed for ${err.providerId} during ${err.operation}:`, err.cause);
}
}
Refresh the Anthropic provider catalog with a 15-second timeout so stale cached models are used gracefully on slow networks.
javascript
copy
const signal = AbortSignal.timeout(15_000);
const result = await modelRuntime.refresh({
providers: ["anthropic"],
signal,
});
if (result.aborted) console.warn("Catalog refresh timed out; using cached models");
for (const [providerId, error] of result.errors) {
console.warn(`Could not refresh ${providerId}:`, error);
}
Adds setRuntimeApiKey(providerId, key) and removeRuntimeApiKey() methods to ModelRuntime for runtime credential management — each resolves once the affected provider's local catalog, composition, and availability snapshot are consistent. Not checked yet Adds CredentialSynchronizationError (with providerId, operation, credential, and cause fields) thrown when credentials are committed but local synchronization fails, enabling structured error inspection instead of blind retry. Not checked yet Adds refresh({ providers, signal }) to ModelRuntime for on-demand provider catalog freshness checks, with optional AbortSignal support for deadline control; returns an object with aborted and errors (keyed by providerId) fields. Not checked yet Adds signal option to ModelRuntime.create() and all public model/auth operations for abort-signal-based deadline control; operations are unbounded when the signal is omitted. Not checked yet New provider-generation model in refresh() ensures a new call does not wait behind a stalled older refresh, and stale generations cannot publish results afterward. Not checked yet
5 details in Everything
Pi custom providers gain thinking-format support with thinkingFormat and chatTemplateArgs fields, plus supportsFinishReason and token-refresh API.
└──▷ USE IT
Configure a Baseten custom provider that toggles chain-of-thought chain-of-thought Intermediate reasoning a model writes out before its final answer. Reasoning models generate it automatically and it is often billed as extra output tokens. thinking via chat_template_args and refreshes OAuth tokens automatically.
yaml
copy
thinkingFormat: "baseten"
chatTemplateArgs:
enable_thinking:
$var: "thinking.enabled"
omitWhenOff: true
thinking_budget:
$var: "thinking.effort"
supportsFinishReason: true
Adds thinkingFormat field to custom provider config, supporting values "openai", "openrouter", "deepseek", "together", "baseten", "zai", "qwen", "chat-template", "qwen-chat-template", "string-thinking", and "ant-ling" to control how thinking/reasoning output is parsed per provider. Not checked yet Adds chatTemplateArgs field (Record<string, string | number | boolean | null | { "$var": "thinking.enabled" | "thinking.effort"; omitWhenOff?: boolean }>) for passing dynamic thinking toggle values under chat_template_args when a provider expects them at the chat-template level. Not checked yet Adds supportsFinishReason optional boolean field to custom provider config to declare whether the provider returns a finish reason. Not checked yet Adds refreshToken(credentials: OAuthCredentials, signal: AbortSignal): Promise<OAuthCredentials> method to the custom provider OAuth interface for programmatic access-token refresh. Not checked yet
4 details in Everything
Pi extensions gain pi.registerMarkdownTransformer() and async dynamic model discovery with cancellation support.
└──▷ USE IT
Replace ASCII arrow sequences with Unicode arrows in finalized assistant messages without touching streaming or thinking output.
javascript
copy
pi.registerMarkdownTransformer((markdown, { messageType, isStreaming }) => {
if (isStreaming || messageType === "assistant-thinking") return markdown;
return markdown.replaceAll("-->", "→");
});
Adds pi.registerMarkdownTransformer(transformer) API to let extensions transform Markdown in user text, assistant text, and assistant-thinking blocks before Pi renders them; transformers receive the Markdown string plus a context with messageType, isStreaming, and availableWidth fields. Not checked yet Transformers chain in extension load order, each receiving the output of the previous one; errors in a transformer are isolated and Pi continues with the next transformer in the chain. Not checked yet Adds async dynamic model discovery callback on providers; returned models replace extension-provided models and can be persisted via context.publish({ persist: entry }) or removed with persist: null. Not checked yet Adds context.signal to provider callbacks, which must be passed to blocking I/O; ModelRuntime.refresh() and ModelRegistry.refresh() accept an optional signal and are unbounded when omitted, letting extensions and applications set their own deadlines. Not checked yet context.stored exposes the persisted provider snapshot so extensions can conditionally update catalog metadata only when new data warrants it. Not checked yet
5 details in Everything
Pi adds fullscreen TUI TUI A text-based user interface that runs inside a terminal, using characters and ANSI escape codes to render menus, panes, and widgets without a graphical desktop, letting cyber tools ship rich interactivity with no GUI dependency. viewport with transcript scrolling, history navigation actions, and configurable keybindings.
└──▷ TRY IT
Launch Pi in fullscreen TUI mode to get a scrollable transcript panel above a fixed editor dock.
copy
$ pi --tui-mode fullscreen
Bind Ctrl+P/Ctrl+N to history navigation in the editor without affecting those keys in selectors or other contexts.
json
copy
{
"tui.editor.historyPrevious": "ctrl+p",
"tui.editor.historyNext": "ctrl+n"
}
Reassign fullscreen transcript paging so Ctrl+PageUp controls the editor and the transcript shortcut is disabled.
json
copy
{
"tui.altScreen.pageUp": []
}
Adds --tui-mode fullscreen flag that enables a dedicated fullscreen viewport with a primary transcript scroll region, fixed editor/status/footer dock, mouse-wheel and two-finger trackpad scrolling, OSC 8 hyperlink support, and click-to-copy text selection. Not checked yet Adds tui.altScreen.pageUp and tui.altScreen.pageDown actions to scroll the fullscreen transcript by one page, defaulting to ctrl+pageUp / ctrl+pageDown. Not checked yet Adds tui.altScreen.previousPrompt (ctrl+shift+up) and tui.altScreen.nextPrompt (ctrl+shift+down) actions to jump between marked messages in the fullscreen transcript. Not checked yet Adds scroll-to-beginning and scroll-to-end/follow actions for the fullscreen transcript. Not checked yet Adds tui.editor.historyPrevious and tui.editor.historyNext actions to navigate prompt history regardless of cursor position in a multiline prompt, bindable independently of application-level shortcuts (e.g. "tui.editor.historyPrevious": "ctrl+p"). Not checked yet
5 details in Everything
Pi adds fullscreen TUI TUI A text-based user interface that runs inside a terminal, using characters and ANSI escape codes to render menus, panes, and widgets without a graphical desktop, letting cyber tools ship rich interactivity with no GUI dependency. mode, configurable scrollbar, image resizing, and Mermaid rendering controls
└──▷ TRY IT
Launch Pi in experimental fullscreen TUI mode to override the default set in config
copy
$ pi --tui-mode fullscreen
Adds tuiMode setting (values: "regular", "fullscreen") and --tui-mode CLI flag to switch between standard and experimental fullscreen TUI modes at startup Not checked yet Adds fullscreenScrollbar setting to control transcript scrollbar visibility in fullscreen mode (values: show temporarily while scrolling, reserve rightmost column and keep visible, or "hidden") Not checked yet Adds markdown.mermaid setting to control Mermaid diagram rendering mode (values: "final", "streaming") Not checked yet Adds automatic image resizing to a 2000×2000 maximum for @file attachments, read, and tool-returned images Not checked yet
4 details in Everything
Pi adds AGENTS.override.md context file override and a new --tui-mode fullscreen terminal UI mode.
└──▷ TRY IT
Launch Pi in fullscreen mode to keep your input and status widgets fixed while scrolling a long transcript.
copy
$ pi --tui-mode fullscreen
Adds AGENTS.override.md support: placing this file in a directory causes Pi to load it instead of the default context file for that directory, while context files from other directories still layer normally. Not checked yet Adds --tui-mode <mode> CLI flag with regular (default) and experimental fullscreen values; fullscreen mode locks the input, status, and footer widgets to the bottom of the viewport while the transcript scrolls inside it, with mouse/trackpad and keyboard scroll support. Not checked yet Supports inline images in fullscreen TUI TUI A text-based user interface that runs inside a terminal, using characters and ANSI escape codes to render menus, panes, and widgets without a graphical desktop, letting cyber tools ship rich interactivity with no GUI dependency. mode for terminals implementing the Kitty graphics protocol Kitty graphics protocol A terminal graphics protocol created by the Kitty terminal emulator project that lets applications render pixel-accurate images directly inside a terminal, giving cyber tools rich visual output without a GUI. (Kitty, Ghostty); iTerm2 renders them as text placeholders in fullscreen due to protocol limitations, while regular mode preserves normal iTerm2 inline-image rendering. Not checked yet
3 details in Everything
Pi 0.84.0 adds fullscreen TUI TUI A text-based user interface that runs inside a terminal, using characters and ANSI escape codes to render menus, panes, and widgets without a graphical desktop, letting cyber tools ship rich interactivity with no GUI dependency. , Mermaid/LaTeX rendering, per-directory context overrides, custom sampling params, and Baseten provider support.
└──▷ TRY IT
Start Pi in fullscreen TUI mode for a distraction-free session with an independently scrollable transcript.
copy
$ pi --tui-mode fullscreen
Override context for a specific subdirectory without affecting parent-directory context files.
copy
$ # Place in the target directory — replaces AGENTS.md or CLAUDE.md in that directory only
echo '# Project-specific override context' > ./src/api/AGENTS.override.md
Pass custom vLLM sampling parameters and a thinking token budget when running a model that supports them.
json
copy
# In model config or extension provider options
{
"samplingParams": { "temperature": 0.2, "top_p": 0.9 },
"thinking_token_budget": 512
}
Adds --tui-mode fullscreen CLI flag to enable fullscreen TUI mode, with a sticky editor/footer dock, independently scrollable transcript, and draggable scrollbars configurable as auto, always, or hidden. Not checked yet Adds AGENTS.override.md per-directory context files that replace AGENTS.md or CLAUDE.md in the same directory while preserving context from other directories. Not checked yet Adds samplingParams support in model config, model overrides, extension providers, and stream options for arbitrary OpenAI-compatible model sampling parameters. Not checked yet Adds opt-in thinking_token_budget for vLLM OpenAI-compatible models to reserve output tokens for the final answer. Not checked yet Adds built-in Baseten provider with BASETEN_API_KEY authentication and zai-org/GLM-5.2 as the default model. Not checked yet
+16 more
show less
Adds pi.registerMarkdownTransformer() chainable hooks for display-only transformation of user and assistant Markdown. Not checked yet Sets AI_AGENT=pi in CLI and RPC RPC Remote Procedure Call, a protocol that lets a program execute a function on another machine as if it were local, giving cyber tools a structured way to communicate across processes or hosts without managing raw sockets. child-process environments for generic agent attribution. Not checked yet Adds AgentOptions.shouldStopAfterTurn to gracefully stop after a completed turn before queued messages or another model call are processed. Not checked yet Adds experimental remote-session client APIs: transport-neutral PiClient, CBOR protocol, Unix-socket transport, and @earendil-works/pi-coding-agent/client RemoteSession controller with transcript reducers. Not checked yet Adds opt-in Ctrl+P / Ctrl+N prompt history navigation, with explicit history bindings taking precedence over application shortcuts while the editor is focused. Not checked yet Adds scrollbarThumb optional theme color for fullscreen scrollbar thumbs, falling back to selectedBg. Not checked yet Adds CredentialSynchronizationError for credential changes that commit successfully but fail to synchronize local model state. Not checked yet Adds runtime switching between regular and fullscreen TUI modes. Not checked yet Adds stacked transient notifications in fullscreen mode. Not checked yet Adds configurable themed Unicode rendering for Mermaid diagrams in interactive messages, including optional rendering while streaming. Not checked yet Adds terminal-friendly Unicode rendering for LaTeX expressions in Markdown. Not checked yet Adds compat.supportsFinishReason support for OpenAI-compatible streams that omit finish_reason, inferring normal and tool-use stops when the stream ends. Not checked yet Adds v4 JsonlSessionRepo and InMemorySessionRepo implementing the new SessionRepo contract for durable and in-memory harness sessions. Not checked yet Adds required FileSystem.renameFile() operation to pi-agent-core for atomic JSONL JSONL A text format where each line is a self-contained, valid JSON object, making it easy to stream, append, and process large datasets line by line without parsing a full JSON array into memory. publication. Not checked yet Adds vendor-neutral telemetry contracts plus agent-owned typed AI-request and harness schemas, composed span starters, and callback helpers. Not checked yet Adds structured Amazon Bedrock failure diagnostics including HTTP status, modeled error code, and AWS request ID. Not checked yet
21 details in Everything
└──▷ BREAKING ON UPGRADE
! The ModelsStreamTransforms interface is renamed to ModelsRequestTransforms; extensions implementing it must update their type references.! JSON and RPC message_update events now emit only assistantMessageEvent deltas; the cumulative message / assistantMessageEvent.partial fields are removed. Clients must now assemble deltas between message_start and message_end.! #7290 now returns ProviderHeaders with string | null values and preserves null header-deletion markers; extensions that inspect returned headers must handle null.! ModelRuntime.setRuntimeApiKey() now accepts auth cancellation options instead of catalog refresh options; callers that relied on it for remote freshness must call refresh({ providers: [providerId], signal }) separately.! Config-form extension OAuth refreshToken(credentials, signal) callbacks are now required to accept and honor a concrete abort signal.! Dynamic provider refresh context store access is replaced with the read-only context.stored snapshot and generation-checked context.publish() transaction; handwritten Provider.refreshModels() implementations must be updated.! The legacy JSONL and in-memory repository APIs from pi-agent-core's experimental entrypoint are removed; use JsonlSessionRepo or InMemorySessionRepo from pi-agent-core's default export.! Custom harness file-system implementations must now provide FileSystem.renameFile() with same-filesystem replacement semantics.! RemoteSession.sessions no longer exposes runtime phase, model, thinking, attachment, or lock state; this data is now available only from acquired SessionSnapshot values.! The experimental pi-agent-core subpaths are removed; the v2 AgentHarness API is now on pi-agent-core's default export.
Pi v0.84.0 adds fullscreen TUI TUI A text-based user interface that runs inside a terminal, using characters and ANSI escape codes to render menus, panes, and widgets without a graphical desktop, letting cyber tools ship rich interactivity with no GUI dependency. , AGENTS.override.md per-directory context, Baseten provider, custom samplingParams, and a remote-session client API.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.84.0 https://github.com/earendil-works/pi.git
$ git checkout v0.84.0
└──▷ TRY IT
Launch Pi in fullscreen TUI mode for a distraction-free session with a scrollable transcript.
copy
$ pi --tui-mode fullscreen
Override context for a sensitive subdirectory without affecting parent-directory context files.
copy
$ # Create AGENTS.override.md in the target directory to replace AGENTS.md/CLAUDE.md there
cat > src/payments/AGENTS.override.md << 'EOF'
# Payments module context
Do not modify stripe integration files without explicit approval.
EOF
Configure a vLLM-hosted model with custom sampling parameters and a thinking token budget.
json
copy
{
"id": "vllm/qwen3-235b",
"samplingParams": {
"temperature": 0.6,
"top_p": 0.95
},
"thinking_token_budget": 8192
}
Adds opt-in Ctrl+P /Ctrl+N prompt history navigation in the TUI editor. Not checked yet
1 detail in Everything
└──▷ BREAKING ON UPGRADE
! The ModelsStreamTransforms interface is renamed to ModelsRequestTransforms; extensions referencing ModelsStreamTransforms will break.! JSON and RPC RPC Remote Procedure Call, a protocol that lets a program execute a function on another machine as if it were local, giving cyber tools a structured way to communicate across processes or hosts without managing raw sockets. message_update events now emit only assistantMessageEvent deltas; the cumulative message and assistantMessageEvent.partial fields are removed. Clients must assemble deltas between message_start and message_end.! ModelRegistry.getApiKeyAndHeaders() now returns ProviderHeaders with string | null values; extensions that inspect returned headers must handle null.! ModelRegistry.refresh() now accepts ModelsRefreshOptions and returns ModelsRefreshResult instead of discarding cancellation and provider errors.! ModelRuntime.setRuntimeApiKey() now accepts auth cancellation options instead of catalog refresh options; callers must call refresh({ providers: [providerId], signal }) separately when remote freshness is required.! Config-form extension OAuth refreshToken(credentials, signal) callbacks are now required to accept and honor a concrete abort signal.! Dynamic provider refresh context store access is replaced with the read-only context.stored snapshot and generation-checked context.publish() transaction; handwritten Provider.refreshModels() implementations using context.store.read() / context.store.write() must migrate.! The inherited pi-agent-core harness session model is replaced with the v4 lane-based Session , SessionStorage, and SessionRepo APIs; code using the old session model will break.! The legacy JSONL JSONL A text format where each line is a self-contained, valid JSON object, making it easy to stream, append, and process large datasets line by line without parsing a full JSON array into memory. and in-memory repository APIs are removed; code must migrate to JsonlSessionRepo or InMemorySessionRepo from pi-agent-core v4.! Custom harness file-system implementations must now provide a FileSystem.renameFile() operation for atomic JSONL publication.! RemoteSession.sessions no longer exposes runtime phase, model, thinking, attachment, or lock state; that data is now only available from acquired SessionSnapshot values.
Pi extensions gain ctx.scopedModels to expose session-scoped model lists in custom UIs.
└──▷ USE IT
Populate a custom model picker in an extension using only the models available in the current session, mirroring the built-in picker without enumerating the full catalogue.
javascript
copy
const models = ctx.scopedModels; // e.g. [{ model: 'anthropic/claude-3-5-sonnet', thinkingLevel: 'high' }, ...]
Adds ctx.scopedModels read-only property to the extension context, exposing the session-resolved list of scoped models (including optional thinkingLevel per entry) for building custom model pickers. Not checked yet
1 detail in Everything
Pi's interactive TUI TUI A text-based user interface that runs inside a terminal, using characters and ANSI escape codes to render menus, panes, and widgets without a graphical desktop, letting cyber tools ship rich interactivity with no GUI dependency. gains an alternate-screen viewport with keyboard, mouse, and hyperlink support via --alt.
└──▷ TRY IT
Stream command output into the alternate-screen viewport so you can scroll, follow live output, and click hyperlinks without cluttering your terminal history.
Pi adds --alt flag for alternate-screen TUI TUI A text-based user interface that runs inside a terminal, using characters and ANSI escape codes to render menus, panes, and widgets without a graphical desktop, letting cyber tools ship rich interactivity with no GUI dependency. with Kitty graphics protocol Kitty graphics protocol A terminal graphics protocol created by the Kitty terminal emulator project that lets applications render pixel-accurate images directly inside a terminal, giving cyber tools rich visual output without a GUI. inline image support.
└──▷ TRY IT
Run Pi in alternate-screen TUI mode to get inline image rendering in Kitty or Ghostty terminals.
Adds --alt flag to launch Pi in an alternate-screen TUI with application-owned scrolling in interactive mode. Not checked yet Supports inline images via the Kitty graphics protocol (Kitty and Ghostty terminals) when --alt is active. Not checked yet
2 details in Everything
Pi 0.83.0 adds credential export commands, headless OpenRouter OpenRouter A unified API gateway that routes requests to dozens of LLM providers under one endpoint, letting cyber tools swap or compare models without rewriting provider-specific integration code. sign-in, Claude Opus 5 via Copilot, and richer provider stream metadata.
└──▷ TRY IT
Export a bearer token bearer token A credential that grants access to whoever presents it, without a separate proof of possession. Protecting the token matters because a stolen copy can be used by someone else. from Pi's configured credentials to pass to an external tool or script that needs a short-lived token.
copy
$ pi auth print-bearer-token
Export an API key from Pi's configured credentials for use with an external client or CI environment.
copy
$ pi auth print-api-key
New pi auth print-api-key and pi auth print-bearer-token commands export configured credentials to external clients with automatic OAuth refresh and configurable minimum token validity. Not checked yet Headless OpenRouter sign-in now supports remote/SSH environments by accepting a manually pasted redirect URL or authorization code when the loopback callback is unavailable. Not checked yet Supports Claude Opus 5 through GitHub Copilot with adaptive thinking and a 1M context window context window The maximum amount of text, counted in tokens, a model can take in and produce in one request. Everything the model knows about the task has to fit inside it. . Not checked yet Adds inherited "pending" stop reason for partial streaming messages in custom provider stream patterns. Not checked yet Adds inherited raw provider stop reasons across Google, Anthropic, Amazon Bedrock, Mistral, and OpenAI streams; unmapped terminal reasons now surface as provider errors instead of successful stops. Not checked yet
+1 more
show less
Adds inherited per-request injection for supported text and image provider transports. Not checked yet
6 details in Everything
└──▷ BREAKING ON UPGRADE
! TypeBox aliases upgraded to 1.3.7, removing Type.Base, Type.Awaited, Type.Promise, Type.AsyncIterator, Type.Iterator, Type.Options, and Value.Mutate — extensions using any of these APIs must migrate to supported TypeBox APIs.
Pi v0.83.0 adds credential export commands, headless OpenRouter OpenRouter A unified API gateway that routes requests to dozens of LLM providers under one endpoint, letting cyber tools swap or compare models without rewriting provider-specific integration code. login, and Claude Opus 5 via GitHub Copilot.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.83.0 https://github.com/earendil-works/pi.git
$ git checkout v0.83.0
└──▷ TRY IT
Pipe a bearer token bearer token A credential that grants access to whoever presents it, without a separate proof of possession. Protecting the token matters because a stolen copy can be used by someone else. into another tool (e.g., a curl call to an API) without manually copying credentials.
copy
$ pi auth print-bearer-token | xargs -I{} curl -H "Authorization: Bearer {}" https://api.example.com/endpoint
Export an API key into an environment variable for a script that calls the provider directly.
copy
$ export API_KEY=$(pi auth print-api-key)
Adds pi auth print-api-key and pi auth print-bearer-token commands to export configured credentials (with automatic OAuth refresh and minimum-validity enforcement) for use by external clients. Not checked yet Enables headless OpenRouter login by accepting a manually pasted redirect URL or authorization code when the loopback callback is unavailable (e.g., over SSH). Not checked yet Adds Claude Opus 5 support through the GitHub Copilot provider, with adaptive thinking and a 1 million-token context window context window The maximum amount of text, counted in tokens, a model can take in and produce in one request. Everything the model knows about the task has to fit inside it. . Not checked yet Adds per-request fetch injection for supported text and image provider transports. Not checked yet Adds the "pending" stop reason for partial streaming messages in the custom provider stream pattern. Not checked yet
5 details in Everything
└──▷ BREAKING ON UPGRADE
! TypeBox aliases upgraded to 1.3.7, removing deprecated APIs Type.Base, Type.Awaited, Type.Promise, Type.AsyncIterator, Type.Iterator, Type.Options, and Value.Mutate — extensions using any of these APIs must migrate to supported TypeBox APIs.
Pi 0.80.6 adds a new max thinking level above xhigh and request-wide input-token pricing tiers for long-context cost accounting.
└──▷ TRY IT
Push reasoning depth to the new maximum level on GPT-5.6 or adaptive Claude models for complex security analysis tasks.
Adds max thinking level opt-in above xhigh, natively supported on GPT-5.6 and adaptive Claude models, available via --thinking max in CLI, SDK, RPC RPC Remote Procedure Call, a protocol that lets a program execute a function on another machine as if it were local, giving cyber tools a structured way to communicate across processes or hosts without managing raw sockets. , and model selection; custom themes can define thinkingMax. Not checked yet Adds request-wide input-token pricing tiers for accurate long-context cost accounting (e.g. GPT-5.4/5.5/5.6 rates), configurable for custom models via models.json, modelOverrides, and extension-registered providers. Not checked yet Adds ~ (home directory) expansion support for the shellPath setting. Not checked yet
3 details in Everything
Pi 0.80.6 adds a new max thinking level above xhigh and request-wide input-token pricing tiers for long-context cost accounting.
└──▷ TRY IT
Push reasoning depth to the new maximum level on GPT-5.6 or adaptive Claude models for complex security analysis tasks.
Adds max thinking level opt-in above xhigh, natively supported on GPT-5.6 and adaptive Claude models, available via --thinking max in CLI, SDK, RPC RPC Remote Procedure Call, a protocol that lets a program execute a function on another machine as if it were local, giving cyber tools a structured way to communicate across processes or hosts without managing raw sockets. , and model selection; custom themes can define thinkingMax. Not checked yet Adds request-wide input-token pricing tiers for accurate long-context cost accounting (e.g. GPT-5.4/5.5/5.6 rates), configurable for custom models via models.json, modelOverrides, and extension-registered providers. Not checked yet Adds ~ (home directory) expansion support for the shellPath setting. Not checked yet
3 details in Everything
Pi 0.80.7 adds cache-friendly dynamic tool loading, Ctrl+X message copy, Fable 5 extended thinking extended thinking Intermediate reasoning a model writes out before its final answer. Reasoning models generate it automatically and it is often billed as extra output tokens. levels, and toolChoice support for OpenAI/Codex Responses.
Adds cache-friendly dynamic tool loading: extensions can inject tools during execution on supported Anthropic and OpenAI Responses models without busting the prompt-cache prefix. Not checked yet New Ctrl+X shortcut copies the last assistant message, or the selected message in /tree, making branched and older messages directly copyable. Not checked yet Adds native xhigh and max thinking levels for Claude Fable 5 across all generated provider catalogs. Not checked yet Adds toolChoice support for OpenAI and Codex Responses providers, including required and named tool selection. Not checked yet
4 details in Everything
└──▷ BREAKING ON UPGRADE
! The compat.sendSessionIdHeader flag is removed from models.json; session-affinity behavior is now controlled by compat.sessionAffinityFormat (openai , openai-nosession , or openrouter ). Replace sendSessionIdHeader: false with sessionAffinityFormat: "openai-nosession".
Pi 0.80.7 adds cache-friendly dynamic tool loading, Ctrl+X message copy, Fable 5 extended thinking extended thinking Intermediate reasoning a model writes out before its final answer. Reasoning models generate it automatically and it is often billed as extra output tokens. levels, and toolChoice support for OpenAI/Codex Responses.
Adds cache-friendly dynamic tool loading: extensions can inject tools during execution on supported Anthropic and OpenAI Responses models without busting the prompt-cache prefix. Not checked yet New Ctrl+X shortcut copies the last assistant message, or the selected message in /tree, making branched and older messages directly copyable. Not checked yet Adds native xhigh and max thinking levels for Claude Fable 5 across all generated provider catalogs. Not checked yet Adds toolChoice support for OpenAI and Codex Responses providers, including required and named tool selection. Not checked yet
4 details in Everything
└──▷ BREAKING ON UPGRADE
! The compat.sendSessionIdHeader flag is removed from models.json; session-affinity behavior is now controlled by compat.sessionAffinityFormat (openai , openai-nosession , or openrouter ). Replace sendSessionIdHeader: false with sessionAffinityFormat: "openai-nosession".
Pi 0.80.8 adds unified ModelRuntime, live model catalog refresh, xAI device-code OAuth, and Grok 4.5 Responses support.
└──▷ TRY IT
Force an immediate model catalog refresh to pick up newly available models without updating pi or extensions.
copy
$ pi update --models
Introduces ModelRuntime as the canonical async SDK facade, centralizing model configuration, provider authentication, and dynamic provider catalogs. Not checked yet Adds provider-owned /login discovery directly from registered pi-ai providers, including ambient auth status and informational links. Not checked yet Adds pi update --models command to force an immediate model catalog refresh without updating pi or extensions. Not checked yet Adds live background refresh in /model: renders the current model snapshot immediately, refreshes configured providers in the background, and updates the open selector with partial results or timeout errors. Not checked yet Adds file-backed dynamic catalogs in models-store.json, per-provider pi.dev catalog overlays, and Radius gateway support including offline migration from legacy credential-cached catalogs. Not checked yet
+3 more
show less
Adds extension provider refreshModels(context) support for dynamic model discovery with optional provider-controlled persistence. Not checked yet Adds xAI device-code OAuth login so users can sign in to xAI interactively. Not checked yet Adds Grok 4.5 OpenAI Responses API support with low, medium, and high thinking levels. Not checked yet
8 details in Everything
└──▷ BREAKING ON UPGRADE
! The SDK's CreateAgentSessionOptions.authStorage and modelRegistry options are replaced with the async modelRuntime option.! AuthStorage and its storage backends are no longer exported; use ModelRuntime (or a custom pi-ai CredentialStore), or readStoredCredential() for one-off reads of auth.json.! ModelRuntime.getAll() , find() , getSnapshot() , and getAuthOptions() are removed; use the pi-ai Models methods getModels() , getModel() , getProviders() , and checkAuth() directly.! SDK request-auth assembly via ModelRegistry.getApiKeyAndHeaders() is replaced by ModelRuntime.getAuth() ; passing a provider ID returns provider-scoped auth, passing a model also resolves built-in, models.json, and extension model headers.! ModelRegistry.refresh() changed from synchronous void to Promise<void> because models.json loading is asynchronous; extensions must await it before making synchronous registry reads.! Canonical dynamic catalog refresh moved to async ModelRuntime.refresh() / pi-ai Models.refresh() ; legacy extension OAuth modifyModels remains supported only as a synchronous compatibility projection after credential initialization.
Pi 0.80.8 adds unified ModelRuntime, live model catalog refresh, xAI device-code OAuth, and Grok 4.5 Responses support.
└──▷ TRY IT
Force an immediate model catalog refresh to pick up newly available models without updating pi or extensions.
copy
$ pi update --models
Introduces ModelRuntime as the canonical async SDK facade, centralizing model configuration, provider authentication, and dynamic provider catalogs. Not checked yet Adds provider-owned /login discovery directly from registered pi-ai providers, including ambient auth status and informational links. Not checked yet Adds pi update --models command to force an immediate model catalog refresh without updating pi or extensions. Not checked yet Adds live background refresh in /model: renders the current model snapshot immediately, refreshes configured providers in the background, and updates the open selector with partial results or timeout errors. Not checked yet Adds file-backed dynamic catalogs in models-store.json, per-provider pi.dev catalog overlays, and Radius gateway support including offline migration from legacy credential-cached catalogs. Not checked yet
+3 more
show less
Adds extension provider refreshModels(context) support for dynamic model discovery with optional provider-controlled persistence. Not checked yet Adds xAI device-code OAuth login so users can sign in to xAI interactively. Not checked yet Adds Grok 4.5 OpenAI Responses API support with low, medium, and high thinking levels. Not checked yet
8 details in Everything
└──▷ BREAKING ON UPGRADE
! The SDK's CreateAgentSessionOptions.authStorage and modelRegistry options are replaced with the async modelRuntime option.! AuthStorage and its storage backends are no longer exported; use ModelRuntime (or a custom pi-ai CredentialStore), or readStoredCredential() for one-off reads of auth.json.! ModelRuntime.getAll() , find() , getSnapshot() , and getAuthOptions() are removed; use the pi-ai Models methods getModels() , getModel() , getProviders() , and checkAuth() directly.! SDK request-auth assembly via ModelRegistry.getApiKeyAndHeaders() is replaced by ModelRuntime.getAuth() ; passing a provider ID returns provider-scoped auth, passing a model also resolves built-in, models.json, and extension model headers.! ModelRegistry.refresh() changed from synchronous void to Promise<void> because models.json loading is asynchronous; extensions must await it before making synchronous registry reads.! Canonical dynamic catalog refresh moved to async ModelRuntime.refresh() / pi-ai Models.refresh() ; legacy extension OAuth modifyModels remains supported only as a synchronous compatibility projection after credential initialization.
Pi 0.80.9 adds Kimi K3 model support with deferred tool loading across multiple providers and updates the default xAI model to Grok 4.5.
Adds Kimi K3 model support across built-in providers including Kimi Coding, Moonshot AI, Moonshot AI China, OpenRouter OpenRouter A unified API gateway that routes requests to dozens of LLM providers under one endpoint, letting cyber tools swap or compare models without rewriting provider-specific integration code. , and Vercel AI Gateway. Not checked yet Adds Kimi deferred tool loading for extension-driven progressive tool activation via Kimi's native protocol. Not checked yet Changes the default xAI model to Grok 4.5 and updates xAI login to use a prefilled device-authorization link labeled Sign in with SuperGrok or X Premium . Not checked yet
3 details in Everything
└──▷ BREAKING ON UPGRADE
! Grok 3, Grok 3 Fast, Grok 4.20 variants, and Grok Code Fast 1 have been removed from the built-in xAI model catalog — any configuration referencing these models will break.
Pi 0.80.9 adds Kimi K3 model support with deferred tool loading across multiple providers and updates the default xAI model to Grok 4.5.
Adds Kimi K3 model support across built-in providers including Kimi Coding, Moonshot AI, Moonshot AI China, OpenRouter OpenRouter A unified API gateway that routes requests to dozens of LLM providers under one endpoint, letting cyber tools swap or compare models without rewriting provider-specific integration code. , and Vercel AI Gateway. Not checked yet Adds Kimi deferred tool loading for extension-driven progressive tool activation via Kimi's native protocol. Not checked yet Changes the default xAI model to Grok 4.5 and updates xAI login to use a prefilled device-authorization link labeled Sign in with SuperGrok or X Premium . Not checked yet
3 details in Everything
└──▷ BREAKING ON UPGRADE
! Grok 3, Grok 3 Fast, Grok 4.20 variants, and Grok Code Fast 1 have been removed from the built-in xAI model catalog — any configuration referencing these models will break.
Pi 0.81.0 adds local llama.cpp model management, full provider extensions, Qwen Token Plan support, and expanded usage accounting.
└──▷ TRY IT
Query available thinking levels for a model programmatically via the RPC RPC Remote Procedure Call, a protocol that lets a program execute a function on another machine as if it were local, giving cyber tools a structured way to communicate across processes or hosts without managing raw sockets. client.
copy
$ client.getAvailableThinkingLevels()
Adds built-in llama.cpp router support with /login connection setup and /llama subcommand for Hugging Face model search, download, explicit load/unload, and live progress. Not checked yet Enables extensions to register complete pi-ai providers with native authentication, model refresh, filtering, and custom streaming behavior. Not checked yet Adds Qwen Token Plan and Qwen Token Plan China as built-in providers with regional endpoints and API-key authentication. Not checked yet Expands usage accounting to persist tool, compaction, and branch-summary usage in session totals, footer, and session statistics. Not checked yet Adds get_available_thinking_levels RPC command and RpcClient.getAvailableThinkingLevels() method for querying model thinking levels. Not checked yet
+1 more
show less
Exports message and tool execution lifecycle event types from the package root. Not checked yet
6 details in Everything
Pi 0.81.0 adds local llama.cpp model management, full provider extensions, Qwen Token Plan support, and expanded usage accounting.
└──▷ TRY IT
Query available thinking levels for a model programmatically via the RPC RPC Remote Procedure Call, a protocol that lets a program execute a function on another machine as if it were local, giving cyber tools a structured way to communicate across processes or hosts without managing raw sockets. client.
copy
$ client.getAvailableThinkingLevels()
Adds built-in llama.cpp router support with /login connection setup and /llama subcommand for Hugging Face model search, download, explicit load/unload, and live progress. Not checked yet Enables extensions to register complete pi-ai providers with native authentication, model refresh, filtering, and custom streaming behavior. Not checked yet Adds Qwen Token Plan and Qwen Token Plan China as built-in providers with regional endpoints and API-key authentication. Not checked yet Expands usage accounting to persist tool, compaction, and branch-summary usage in session totals, footer, and session statistics. Not checked yet Adds get_available_thinking_levels RPC command and RpcClient.getAvailableThinkingLevels() method for querying model thinking levels. Not checked yet
+1 more
show less
Exports message and tool execution lifecycle event types from the package root. Not checked yet
6 details in Everything
Pi 0.81.1 adds verifiable, checksummed source archives to GitHub releases for reproducible standalone binary builds.
Pi 0.81.1 adds verifiable, checksummed source archives to GitHub releases for reproducible standalone binary builds.
└──▷ TRY IT
Authorize OpenRouter OpenRouter A unified API gateway that routes requests to dozens of LLM providers under one endpoint, letting cyber tools swap or compare models without rewriting provider-specific integration code. or Kimi Code without manually setting API keys — use /login inside Pi.
Inspect current session context inside a bash tool to branch logic by provider or model at runtime.
copy
$ echo "Session: $PI_SESSION_ID Provider: $PI_PROVIDER Model: $PI_MODEL Reasoning: $PI_REASONING_LEVEL"
Supports Kimi Code subscription OAuth login (device authorization + automatic token refresh) via /login for the Kimi For Coding provider. Not checked yet
Pi: Supports Kimi Code subscription OAuth login (device authorization + automatic token refresh) via /login for the Kimi For Coding provider.
└──▷ TRY IT
Authorize OpenRouter OpenRouter A unified API gateway that routes requests to dozens of LLM providers under one endpoint, letting cyber tools swap or compare models without rewriting provider-specific integration code. or Kimi Code without manually setting API keys — use /login inside Pi.
Inspect current session context inside a bash tool to branch logic by provider or model at runtime.
copy
$ echo "Session: $PI_SESSION_ID Provider: $PI_PROVIDER Model: $PI_MODEL Reasoning: $PI_REASONING_LEVEL"
Pi 0.82.1 adds Claude Opus 5 with adaptive thinking, bearer auth for Anthropic-compatible gateways, and faster model catalog revalidation.
└──▷ TRY IT
Authenticate against an Anthropic-compatible gateway (e.g. a corporate proxy) that requires bearer token bearer token A credential that grants access to whoever presents it, without a separate proof of possession. Protecting the token matters because a stolen copy can be used by someone else. auth.
copy
$ export ANTHROPIC_AUTH_TOKEN=<your-token>
Adds Claude Opus 5 support on Anthropic and Amazon Bedrock with adaptive thinking (including xhigh), inference profiles, and prompt caching. Not checked yet New ANTHROPIC_AUTH_TOKEN environment variable authenticates against Anthropic-compatible gateways requiring Authorization: Bearer, covering compaction and branch summaries. Not checked yet Pi.dev model catalogs now revalidate using If-None-Match , so unchanged providers return a 304 instead of a full download, reducing startup overhead. Not checked yet Exposes the outputPad setting to custom message renderers via the Extensions API. Not checked yet
4 details in Everything
Pi 0.82.1 adds Claude Opus 5 with adaptive thinking, bearer auth for Anthropic-compatible gateways, and faster model catalog revalidation.
└──▷ TRY IT
Authenticate against an Anthropic-compatible gateway (e.g. a corporate proxy) that requires bearer token bearer token A credential that grants access to whoever presents it, without a separate proof of possession. Protecting the token matters because a stolen copy can be used by someone else. auth.
copy
$ export ANTHROPIC_AUTH_TOKEN=<your-token>
Adds Claude Opus 5 support on Anthropic and Amazon Bedrock with adaptive thinking (including xhigh), inference profiles, and prompt caching. Not checked yet New ANTHROPIC_AUTH_TOKEN environment variable authenticates against Anthropic-compatible gateways requiring Authorization: Bearer, covering compaction and branch summaries. Not checked yet Pi.dev model catalogs now revalidate using If-None-Match , so unchanged providers return a 304 instead of a full download, reducing startup overhead. Not checked yet Exposes the outputPad setting to custom message renderers via the Extensions API. Not checked yet
4 details in Everything
Pi 0.82.x adds Claude Opus 5, OpenRouter OpenRouter A unified API gateway that routes requests to dozens of LLM providers under one endpoint, letting cyber tools swap or compare models without rewriting provider-specific integration code. /Kimi sign-in, constrained tool sampling, and session-aware streaming bash integrations.
└──▷ TRY IT
Authenticate against a corporate Anthropic-compatible gateway that requires Bearer tokens Bearer tokens A credential that grants access to whoever presents it, without a separate proof of possession. Protecting the token matters because a stolen copy can be used by someone else. instead of a raw API key.
copy
$ ANTHROPIC_AUTH_TOKEN=<your-bearer-token> pi
Sign in to OpenRouter without manually managing an API key — Pi mints a user-controlled key via PKCE PKCE Proof Key for Code Exchange, an OAuth safeguard that binds an authorization code to the client that requested it. An intercepted code cannot be redeemed without the client's matching verifier. .
Write a bash tool script that adapts its behaviour based on which model and reasoning level is currently active.
copy
$ echo "Session: $PI_SESSION_ID Provider: $PI_PROVIDER Model: $PI_MODEL Reasoning: $PI_REASONING_LEVEL"
Adds Claude Opus 5 support on Anthropic and Amazon Bedrock with adaptive thinking (including xhigh), inference profiles, and prompt caching. Not checked yet Adds ANTHROPIC_AUTH_TOKEN bearer auth for Anthropic-compatible gateways, enabling compaction and branch summaries against custom gateway endpoints. Not checked yet Adds /login OAuth flow for OpenRouter (PKCE) and Kimi Code subscriptions, eliminating manual API key configuration. Not checked yet Adds Tool.constrainedSampling for strict JSON Schema (prefer/require) and OpenAI Lark/regex grammar-constrained tool calls, with per-model capability gating across OpenAI, Anthropic, Bedrock, Gemini, and Mistral. Not checked yet Exposes PI_SESSION_ID, PI_SESSION_FILE, PI_PROVIDER, PI_MODEL, and PI_REASONING_LEVEL to bash tools, giving scripts access to current session and model metadata. Not checked yet
+1 more
show less
Exposes outputPad setting to custom message renderers via the Extensions API. Not checked yet
6 details in Everything
Pi: Adds ANTHROPIC_AUTH_TOKEN bearer auth for Anthropic-compatible gateways, enabling compaction and branch summaries against custom gateway endpoints.
└──▷ TRY IT
Authenticate against a corporate Anthropic-compatible gateway that requires Bearer tokens Bearer tokens A credential that grants access to whoever presents it, without a separate proof of possession. Protecting the token matters because a stolen copy can be used by someone else. instead of a raw API key.
copy
$ ANTHROPIC_AUTH_TOKEN=<your-bearer-token> pi
Sign in to OpenRouter OpenRouter A unified API gateway that routes requests to dozens of LLM providers under one endpoint, letting cyber tools swap or compare models without rewriting provider-specific integration code. without manually managing an API key — Pi mints a user-controlled key via PKCE PKCE Proof Key for Code Exchange, an OAuth safeguard that binds an authorization code to the client that requested it. An intercepted code cannot be redeemed without the client's matching verifier. .
Write a bash tool script that adapts its behaviour based on which model and reasoning level is currently active.
copy
$ echo "Session: $PI_SESSION_ID Provider: $PI_PROVIDER Model: $PI_MODEL Reasoning: $PI_REASONING_LEVEL"
Adds /login OAuth flow for OpenRouter (PKCE) and Kimi Code subscriptions, eliminating manual API key configuration. Not checked yet Exposes PI_SESSION_ID, PI_SESSION_FILE, PI_PROVIDER, PI_MODEL, and PI_REASONING_LEVEL to bash tools, giving scripts access to current session and model metadata. Not checked yet
2 details in Everything
Pi exposes session state (model, provider, reasoning level, session ID/file) to bash tool commands via PI_* environment variables.
└──▷ TRY IT
Inspect the active model, provider, and reasoning level from within a bash tool command to make agent behavior conditional on current session config.
copy
$ printf '%s/%s reasoning=%s session=%s\n' "$PI_PROVIDER" "$PI_MODEL" "$PI_REASONING_LEVEL" "$PI_SESSION_ID"
Read the last entry of the current session file for lightweight session introspection inside a bash tool.
copy
$ if [ -n "$PI_SESSION_FILE" ]; then
tail -n 1 "$PI_SESSION_FILE"
fi
Disable session metadata injection on a custom bash tool so nested Pi processes don't inherit stale parent-session variables.
javascript
copy
const bashTool = createBashTool(cwd, {
exposeSessionEnvironment: false,
spawnHook: (ctx) => ctx,
});
Adds PI_CODING_AGENT=true marker so child processes can detect they run inside Pi. Not checked yet Adds PI_CODING_AGENT_DIR and PI_CODING_AGENT_SESSION_DIR to override config and session storage directories. Not checked yet Adds PI_CACHE_RETENTION=long to enable extended provider prompt caching where supported. Not checked yet Adds PI_OFFLINE to disable all startup network operations including update checks and telemetry. Not checked yet Adds PI_TELEMETRY to override install/update telemetry and provider attribution headers. Not checked yet
+3 more
show less
Adds PI_HARDWARE_CURSOR=1 to enable hardware cursor display. Not checked yet Adds PI_SHARE_VIEWER_URL to override the base URL used by /share. Not checked yet Supports HTTP_PROXY / HTTPS_PROXY for proxying outbound HTTP requests. Not checked yet
8 details in Everything
Pi: Adds PI_CODING_AGENT=true marker so child processes can detect they run inside Pi.
└──▷ TRY IT
Inspect the active model, provider, and reasoning level from within a bash tool command to make agent behavior conditional on current session config.
copy
$ printf '%s/%s reasoning=%s session=%s\n' "$PI_PROVIDER" "$PI_MODEL" "$PI_REASONING_LEVEL" "$PI_SESSION_ID"
Read the last entry of the current session file for lightweight session introspection inside a bash tool.
copy
$ if [ -n "$PI_SESSION_FILE" ]; then
tail -n 1 "$PI_SESSION_FILE"
fi
Disable session metadata injection on a custom bash tool so nested Pi processes don't inherit stale parent-session variables.
javascript
copy
const bashTool = createBashTool(cwd, {
exposeSessionEnvironment: false,
spawnHook: (ctx) => ctx,
});
Adds PI_CODING_AGENT_DIR and PI_CODING_AGENT_SESSION_DIR to override config and session storage directories. Not checked yet Adds PI_CACHE_RETENTION=long to enable extended provider prompt caching where supported. Not checked yet Adds PI_OFFLINE to disable all startup network operations including update checks and telemetry. Not checked yet Adds PI_TELEMETRY to override install/update telemetry and provider attribution headers. Not checked yet Adds PI_HARDWARE_CURSOR=1 to enable hardware cursor display. Not checked yet
+2 more
show less
Adds PI_SHARE_VIEWER_URL to override the base URL used by /share. Not checked yet Supports HTTP_PROXY / HTTPS_PROXY for proxying outbound HTTP requests. Not checked yet
7 details in Everything
Pi 0.82.1 adds Claude Opus 5 support, bearer auth for Anthropic-compatible gateways, and faster model catalog revalidation.
Adds Claude Opus 5 support on Anthropic and Amazon Bedrock with adaptive thinking (including extended thinking extended thinking Intermediate reasoning a model writes out before its final answer. Reasoning models generate it automatically and it is often billed as extra output tokens. ), inference profiles, and prompt caching. Not checked yet New ANTHROPIC_AUTH_TOKEN environment variable authenticates against Anthropic-compatible gateways requiring Authorization: Bearer, covering compaction and branch summaries. Not checked yet Model catalog refreshes now use If-None-Match HTTP conditional requests so unchanged provider catalogs return a 304 instead of a full re-download, reducing overhead. Not checked yet llama.cpp models now remain listed in the catalog across restarts. Not checked yet Radius OAuth device authorization, token exchange token exchange An OAuth 2.0 protocol extension (RFC 8693) that lets a service trade one token for another with different scopes, audience, or type, enabling delegation and impersonation across service boundaries without re-authenticating the user. , and refresh requests now route through the configured gateway directly. Not checked yet
+1 more
show less
Model loading errors now append the underlying cause (e.g. provider OAuth failure) for clearer diagnostics. Not checked yet
6 details in Everything
Pi: llama.cpp models now remain listed in the catalog across restarts.
Radius OAuth device authorization, token exchange token exchange An OAuth 2.0 protocol extension (RFC 8693) that lets a service trade one token for another with different scopes, audience, or type, enabling delegation and impersonation across service boundaries without re-authenticating the user. , and refresh requests now route through the configured gateway directly. Not checked yet Model loading errors now append the underlying cause (e.g. provider OAuth failure) for clearer diagnostics. Not checked yet
2 details in Everything
Pi v0.82.1 adds Claude Opus 5 support, bearer auth for Anthropic-compatible gateways, and faster model catalog revalidation.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.82.1 https://github.com/earendil-works/pi.git
$ git checkout v0.82.1
└──▷ TRY IT
Authenticate against an Anthropic-compatible gateway that requires bearer token bearer token A credential that grants access to whoever presents it, without a separate proof of possession. Protecting the token matters because a stolen copy can be used by someone else. auth instead of an API key.
copy
$ export ANTHROPIC_AUTH_TOKEN=<your-bearer-token>
Adds Claude Opus 5 model support on Anthropic and Amazon Bedrock, including adaptive thinking (with xhigh level), inference profiles, and prompt caching. Not checked yet Adds ANTHROPIC_AUTH_TOKEN bearer authentication for Anthropic-compatible gateways that require Authorization: Bearer headers, covering compaction and branch summaries. Not checked yet Speeds up pi.dev model catalog refreshes with If-None-Match conditional requests, so unchanged provider catalogs return a 304 instead of a full download. Not checked yet Exposes the outputPad setting to custom message renderers via the Extensions API. Not checked yet
4 details in Everything
Pi's createBashTool() now injects session context (model, provider, reasoning level) into bash commands via environment variables.
└──▷ TRY IT
Disable session variable injection in a bash tool when you want a clean environment without Pi session metadata leaking into subprocesses.
copy
$ exposeSessionEnvironment: false,
Adds ctx.modelRegistry, ctx.model, and ctx.thinkingLevel to expose the active model and its current effective thinking level in extension contexts. Not checked yet Injects session environment variables (PI_SESSION_ID, PI_SESSION_FILE, PI_PROVIDER, PI_MODEL, PI_REASONING_LEVEL) into bash tool commands before hook execution, giving scripts access to live session state. Not checked yet Adds exposeSessionEnvironment: false option to createBashTool() to opt out of automatic session variable injection. Not checked yet
3 details in Everything
Pi's createBashTool() now injects session context (model, provider, reasoning level) into bash commands via environment variables.
└──▷ TRY IT
Disable session variable injection in a bash tool when you want a clean environment without Pi session metadata leaking into subprocesses.
copy
$ exposeSessionEnvironment: false,
Adds ctx.modelRegistry, ctx.model, and ctx.thinkingLevel to expose the active model and its current effective thinking level in extension contexts. Not checked yet Injects session environment variables (PI_SESSION_ID, PI_SESSION_FILE, PI_PROVIDER, PI_MODEL, PI_REASONING_LEVEL) into bash tool commands before hook execution, giving scripts access to live session state. Not checked yet Adds exposeSessionEnvironment: false option to createBashTool() to opt out of automatic session variable injection. Not checked yet
3 details in Everything
Pi 0.82.0 adds constrained tool sampling, OpenRouter OpenRouter A unified API gateway that routes requests to dozens of LLM providers under one endpoint, letting cyber tools swap or compare models without rewriting provider-specific integration code. /Kimi OAuth sign-in, and session-aware streaming bash integrations.
└──▷ TRY IT
Inspect session context from inside a bash tool — useful when a script needs to branch on which provider or model is active.
copy
$ echo "Session: $PI_SESSION_ID | Provider: $PI_PROVIDER | Model: $PI_MODEL | Reasoning: $PI_REASONING_LEVEL"
Adds Tool.constrainedSampling to let tools prefer or require strict JSON Schema sampling, or use OpenAI Lark/regex grammars, across OpenAI, Anthropic, Amazon Bedrock, Google Gemini, and Mistral. Not checked yet Adds supportsGrammarTools, supportsStrictTools, and expanded supportsStrictMode compatibility flags plus generated model capability metadata to gate constrained sampling requests. Not checked yet Adds OAuth PKCE PKCE Proof Key for Code Exchange, an OAuth safeguard that binds an authorization code to the client that requested it. An intercepted code cannot be redeemed without the client's matching verifier. sign-in for OpenRouter, minting a user-controlled API key without manual configuration. Not checked yet Adds inherited Kimi Code subscription OAuth login for the Kimi For Coding provider, including device authorization and automatic token refresh. Not checked yet Exposes PI_SESSION_ID, PI_SESSION_FILE, PI_PROVIDER, PI_MODEL, and PI_REASONING_LEVEL environment variables to commands run by built-in and factory-created bash tools. Not checked yet
+2 more
show less
Adds streaming bash_execution_update events for direct RPC RPC Remote Procedure Call, a protocol that lets a program execute a function on another machine as if it were local, giving cyber tools a structured way to communicate across processes or hosts without managing raw sockets. bash commands, correlated with request IDs. Not checked yet Model catalogs now expose only provider-verified reasoning effort levels sourced from models.dev. Not checked yet
7 details in Everything
Pi 0.82.0 adds constrained tool sampling, OpenRouter OpenRouter A unified API gateway that routes requests to dozens of LLM providers under one endpoint, letting cyber tools swap or compare models without rewriting provider-specific integration code. /Kimi OAuth sign-in, and session-aware streaming bash integrations.
└──▷ TRY IT
Inspect session context from inside a bash tool — useful when a script needs to branch on which provider or model is active.
copy
$ echo "Session: $PI_SESSION_ID | Provider: $PI_PROVIDER | Model: $PI_MODEL | Reasoning: $PI_REASONING_LEVEL"
Adds Tool.constrainedSampling to let tools prefer or require strict JSON Schema sampling, or use OpenAI Lark/regex grammars, across OpenAI, Anthropic, Amazon Bedrock, Google Gemini, and Mistral. Not checked yet Adds supportsGrammarTools, supportsStrictTools, and expanded supportsStrictMode compatibility flags plus generated model capability metadata to gate constrained sampling requests. Not checked yet Adds OAuth PKCE PKCE Proof Key for Code Exchange, an OAuth safeguard that binds an authorization code to the client that requested it. An intercepted code cannot be redeemed without the client's matching verifier. sign-in for OpenRouter, minting a user-controlled API key without manual configuration. Not checked yet Adds inherited Kimi Code subscription OAuth login for the Kimi For Coding provider, including device authorization and automatic token refresh. Not checked yet Exposes PI_SESSION_ID, PI_SESSION_FILE, PI_PROVIDER, PI_MODEL, and PI_REASONING_LEVEL environment variables to commands run by built-in and factory-created bash tools. Not checked yet
+2 more
show less
Adds streaming bash_execution_update events for direct RPC RPC Remote Procedure Call, a protocol that lets a program execute a function on another machine as if it were local, giving cyber tools a structured way to communicate across processes or hosts without managing raw sockets. bash commands, correlated with request IDs. Not checked yet Model catalogs now expose only provider-verified reasoning effort levels sourced from models.dev. Not checked yet
7 details in Everything
Pi v0.82.0 adds constrained tool sampling, OAuth login for OpenRouter OpenRouter A unified API gateway that routes requests to dozens of LLM providers under one endpoint, letting cyber tools swap or compare models without rewriting provider-specific integration code. /Kimi Code, and streaming bash RPC RPC Remote Procedure Call, a protocol that lets a program execute a function on another machine as if it were local, giving cyber tools a structured way to communicate across processes or hosts without managing raw sockets. events.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.82.0 https://github.com/earendil-works/pi.git
$ git checkout v0.82.0
└──▷ TRY IT
Authenticate with OpenRouter interactively so Pi can use it without manually setting an API key.
Inspect session and model context from inside a bash tool script — useful for writing tools that behave differently per provider or model.
copy
$ echo "Session: $PI_SESSION_ID | Provider: $PI_PROVIDER | Model: $PI_MODEL | Reasoning: $PI_REASONING_LEVEL"
Adds Tool.constrainedSampling supporting strict JSON Schema (prefer/require) and OpenAI Lark/regex grammar variants across OpenAI, Anthropic, Amazon Bedrock, Google Gemini, and Mistral providers. Not checked yet Adds model capability flags supportsGrammarTools and supportsStrictTools to gate constrained sampling requests to models that support them. Not checked yet Adds OAuth PKCE PKCE Proof Key for Code Exchange, an OAuth safeguard that binds an authorization code to the client that requested it. An intercepted code cannot be redeemed without the client's matching verifier. login for OpenRouter via /login, automatically minting a user-controlled API key without manual configuration. Not checked yet Adds OAuth device-authorization login for Kimi Code subscriptions via /login, with automatic token refresh. Not checked yet Exposes PI_SESSION_ID, PI_SESSION_FILE, PI_PROVIDER, PI_MODEL, and PI_REASONING_LEVEL as environment variables inside commands run by built-in and factory-created bash tools. Not checked yet
+1 more
show less
Adds streaming bash_execution_update RPC events for direct bash commands, correlated with request IDs. Not checked yet
6 details in Everything
Pi RPC RPC Remote Procedure Call, a protocol that lets a program execute a function on another machine as if it were local, giving cyber tools a structured way to communicate across processes or hosts without managing raw sockets. adds retry-lifecycle events for compaction and branch-summary summarization failures.
New summarization_retry_scheduled, summarization_retry_attempt_start, and summarization_retry_finished RPC events expose the full retry lifecycle when compaction or branch-summary summarization hits a transient provider error. Not checked yet
1 detail in Everything
Pi RPC RPC Remote Procedure Call, a protocol that lets a program execute a function on another machine as if it were local, giving cyber tools a structured way to communicate across processes or hosts without managing raw sockets. adds retry-lifecycle events for compaction and branch-summary summarization failures.
New summarization_retry_scheduled, summarization_retry_attempt_start, and summarization_retry_finished RPC events expose the full retry lifecycle when compaction or branch-summary summarization hits a transient provider error. Not checked yet
1 detail in Everything
Pi adds OpenRouter OpenRouter A unified API gateway that routes requests to dozens of LLM providers under one endpoint, letting cyber tools swap or compare models without rewriting provider-specific integration code. as an OAuth provider, minting a user-controlled API key billed from OpenRouter credits.
└──▷ TRY IT
Authenticate Pi with OpenRouter to use your OpenRouter credits as the billing source.
Pi adds OpenRouter OpenRouter A unified API gateway that routes requests to dozens of LLM providers under one endpoint, letting cyber tools swap or compare models without rewriting provider-specific integration code. as an OAuth provider, minting a user-controlled API key billed from OpenRouter credits.
└──▷ TRY IT
Authenticate Pi with OpenRouter to use your OpenRouter credits as the billing source.
Pi adds Google Gemini 3.5 Flash Lite, Gemini 3.6 Flash, and Poolside Laguna S 2.1 to its model catalog.
Adds Google Gemini 3.5 Flash Lite (google/gemini-3.5-flash-lite) as a new available model. Not checked yet Adds Google Gemini 3.6 Flash (google/gemini-3.6-flash) as a new available model. Not checked yet Adds Poolside Laguna S 2.1 (poolside/laguna-s-2.1) and a free tier variant (poolside/laguna-s-2.1:free) as new available models. Not checked yet
3 details in Everything
Pi adds Google Gemini 3.5 Flash Lite, Gemini 3.6 Flash, and Poolside Laguna S 2.1 to its model catalog.
Adds Google Gemini 3.5 Flash Lite (google/gemini-3.5-flash-lite) as a new available model. Not checked yet Adds Google Gemini 3.6 Flash (google/gemini-3.6-flash) as a new available model. Not checked yet Adds Poolside Laguna S 2.1 (poolside/laguna-s-2.1) and a free tier variant (poolside/laguna-s-2.1:free) as new available models. Not checked yet
3 details in Everything
Pi 0.81.1 adds verifiable release source archives and resilient compaction with retry lifecycle events.
Adds deterministic, checksummed source archives to GitHub releases with documented instructions for rebuilding standalone binaries. Not checked yet Transient provider failures during compaction and branch summaries now follow the configured retry policy, with retry lifecycle events exposed to interactive, JSON, RPC RPC Remote Procedure Call, a protocol that lets a program execute a function on another machine as if it were local, giving cyber tools a structured way to communicate across processes or hosts without managing raw sockets. , and SDK consumers. Not checked yet
2 details in Everything
Pi 0.81.1 adds verifiable release source archives and resilient compaction with retry lifecycle events.
Adds deterministic, checksummed source archives to GitHub releases with documented instructions for rebuilding standalone binaries. Not checked yet Transient provider failures during compaction and branch summaries now follow the configured retry policy, with retry lifecycle events exposed to interactive, JSON, RPC RPC Remote Procedure Call, a protocol that lets a program execute a function on another machine as if it were local, giving cyber tools a structured way to communicate across processes or hosts without managing raw sockets. , and SDK consumers. Not checked yet
2 details in Everything
Pi v0.81.1 adds verifiable, checksummed release source archives for reproducible standalone binary builds.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.81.1 https://github.com/earendil-works/pi.git
$ git checkout v0.81.1
Adds deterministic, checksummed source archives to GitHub releases with documented instructions for rebuilding standalone binaries, supporting supply-chain verification. Not checked yet
1 detail in Everything
Pi RPC RPC Remote Procedure Call, a protocol that lets a program execute a function on another machine as if it were local, giving cyber tools a structured way to communicate across processes or hosts without managing raw sockets. adds get_available_thinking_levels command and cost tracking fields across session and tool usage.
New get_available_thinking_levels RPC command returns the reasoning/thinking levels supported by the current model (e.g. off, minimal, low, medium, high). Not checked yet Session-level usage now includes a cost object (input, output, cacheRead, cacheWrite, total) covering the full session including compaction and branch-summary generation. Not checked yet Tool usage responses now support an optional usage field reporting nested LLM LLM A large language model, a neural network trained on large amounts of text to recognize patterns and generate language. Applications use it for tasks such as answering, summarizing and writing code. token and cost totals contributed by the tool to session-wide accounting. Not checked yet
3 details in Everything
Pi adds Qwen Token Plan provider support, including a China-region variant.
└──▷ USE IT
Route requests through the Qwen Token Plan (global) provider by adding it to your Pi provider config.
json
copy
"qwen-token-plan": { "type": "api_key", "key": "sk-sp-..." }
Route requests through the Qwen Token Plan China-region provider for CN-hosted workloads.
json
copy
"qwen-token-plan-cn": { "type": "api_key", "key": "sk-sp-..." }
Adds qwen-token-plan as a new provider, configured via QWEN_TOKEN_PLAN_API_KEY. Not checked yet Adds qwen-token-plan-cn as a China-region Qwen Token Plan provider, configured via QWEN_TOKEN_PLAN_CN_API_KEY. Not checked yet
2 details in Everything
Pi 0.81.0 adds llama.cpp model management, full provider extensions, Qwen Token Plan support, and expanded usage accounting.
└──▷ TRY IT
Search for and download a Hugging Face model through the built-in llama.cpp router integration.
Adds local llama.cpp router integration: connect to a router, search and download Hugging Face models, and explicitly load or unload models with live progress. Not checked yet Enables extensions to register complete pi-ai providers with native authentication, model refresh, filtering, and custom streaming behavior. Not checked yet Adds built-in Qwen Token Plan and Qwen Token Plan China providers with regional endpoints and API-key authentication. Not checked yet Adds get_available_thinking_levels RPC RPC Remote Procedure Call, a protocol that lets a program execute a function on another machine as if it were local, giving cyber tools a structured way to communicate across processes or hosts without managing raw sockets. command and RpcClient.getAvailableThinkingLevels() method for querying available thinking levels. Not checked yet Exports message and tool execution lifecycle event types from the package root. Not checked yet
+1 more
show less
Expands usage accounting to persist tool, compaction, and branch-summary usage across sessions, included in footer totals and session statistics. Not checked yet
6 details in Everything
Pi v0.81.0 adds local llama.cpp model management, full provider extensions, Qwen Token Plan support, and expanded usage accounting.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.81.0 https://github.com/earendil-works/pi.git
$ git checkout v0.81.0
└──▷ TRY IT
Connect to a local llama.cpp router and search for a Hugging Face model to download and load — without leaving the Pi session.
copy
$ /login
/llama <model-search-query>
Adds built-in llama.cpp router support via /login connection setup and /llama subcommand for Hugging Face model search, download, explicit load/unload, and live progress. Not checked yet Enables extensions to register complete pi-ai providers with native authentication, model refresh, filtering, and custom streaming behavior. Not checked yet Adds Qwen Token Plan and Qwen Token Plan China as built-in providers with regional endpoints and API-key authentication. Not checked yet Expands usage accounting to persist tool, compaction, and branch-summary usage in session totals and statistics. Not checked yet Adds get_available_thinking_levels RPC RPC Remote Procedure Call, a protocol that lets a program execute a function on another machine as if it were local, giving cyber tools a structured way to communicate across processes or hosts without managing raw sockets. command and RpcClient.getAvailableThinkingLevels() method for querying model thinking-level options. Not checked yet
+1 more
show less
Exports message and tool execution lifecycle event types from the package root for consumer use. Not checked yet
6 details in Everything
Pi v0.80.10 adds Kimi Coding adaptive thinking support with max level and empty-signature thinking block replay for K3.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.80.10 https://github.com/earendil-works/pi.git
$ git checkout v0.80.10
Kimi Coding models now use adaptive thinking correctly; K3 exposes its supported max thinking level and supports replaying empty-signature thinking blocks. Not checked yet
1 detail in Everything
Pi v0.80.9 adds Kimi K3 support with deferred tool loading across five providers and switches xAI default to Grok 4.5.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.80.9 https://github.com/earendil-works/pi.git
$ git checkout v0.80.9
Adds Kimi K3 model support across Kimi Coding, Moonshot AI, Moonshot AI China, OpenRouter OpenRouter A unified API gateway that routes requests to dozens of LLM providers under one endpoint, letting cyber tools swap or compare models without rewriting provider-specific integration code. , and Vercel AI Gateway. Not checked yet Adds Kimi deferred tool loading for progressive, extension-driven tool activation via Kimi's native protocol. Not checked yet Changes the default xAI model to Grok 4.5 and updates xAI login to use a prefilled device-authorization link labeled Sign in with SuperGrok or X Premium . Not checked yet
3 details in Everything
└──▷ BREAKING ON UPGRADE
! Grok 3, Grok 3 Fast, Grok 4.20 variants, and Grok Code Fast 1 have been removed from the built-in xAI model catalog — any configuration referencing these models will break.
Pi v0.80.8 adds unified model/auth runtime, live catalog refresh, and xAI Grok 4.5 with device-code OAuth.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.80.8 https://github.com/earendil-works/pi.git
$ git checkout v0.80.8
└──▷ TRY IT
Force a full model catalog refresh after adding a new provider, without reinstalling pi or extensions.
copy
$ pi update --models
Adds ModelRuntime as the canonical async SDK facade, centralizing model configuration, provider authentication, and dynamic provider catalogs. Not checked yet Adds pi update --models command to force an immediate model catalog refresh without updating pi or extensions. Not checked yet Adds /model live background refresh of configured providers, updating the selector with partial results as they arrive. Not checked yet Adds provider-owned /login discovery, surfacing ambient auth status and informational links directly from registered providers. Not checked yet Adds xAI device-code OAuth login so users can authenticate to xAI interactively without an API key. Not checked yet
+3 more
show less
Adds Grok 4.5 OpenAI Responses support with selectable low, medium, and high thinking levels. Not checked yet Adds file-backed dynamic model catalogs (models-store.json), per-provider pi.dev catalog overlays, and Radius gateway support. Not checked yet Adds refreshModels(context) extension hook for dynamic model discovery with optional provider-controlled persistence. Not checked yet
8 details in Everything
└──▷ BREAKING ON UPGRADE
! The CreateAgentSessionOptions.authStorage and modelRegistry SDK options are replaced by the async modelRuntime option; AuthStorage and its storage backends are no longer exported — use ModelRuntime, a custom pi-ai CredentialStore, or readStoredCredential() instead.! ModelRuntime.getAll() , find() , getSnapshot() , and getAuthOptions() are removed; use pi-ai Models methods getModels() , getModel() , getProviders() , and checkAuth() directly.! Request-auth assembly via ModelRegistry.getApiKeyAndHeaders() is replaced by ModelRuntime.getAuth() ; passing a provider ID returns provider-scoped auth, passing a model also resolves built-in, models.json, and extension model headers.! ModelRegistry.refresh() changed from synchronous void to Promise<void>; extensions must await it before making synchronous registry reads.
Pi v0.80.7 adds cache-friendly dynamic tool loading, toolChoice for OpenAI/Codex Responses, Fable 5 xhigh/max thinking, and a Ctrl+X message copy shortcut.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.80.7 https://github.com/earendil-works/pi.git
$ git checkout v0.80.7
Adds cache-friendly dynamic tool loading: extensions can inject tools during execution while Anthropic and OpenAI Responses models preserve prompt-cache prefixes. Not checked yet Adds toolChoice support for OpenAI and Codex Responses, including required and named tool selection. Not checked yet Adds native xhigh and max thinking levels for Claude Fable 5 across all generated provider catalogs. Not checked yet Adds Ctrl+X shortcut to copy the last assistant message in the transcript, or the selected message in /tree. Not checked yet
4 details in Everything
└──▷ BREAKING ON UPGRADE
! The compat.sendSessionIdHeader flag has been removed from models.json for openai-responses models. Replace sendSessionIdHeader: false with sessionAffinityFormat: "openai-nosession" in your models.json; the new field also accepts "openai" and "openrouter".
Pi v0.80.6 adds a max thinking level for GPT-5.6/Claude and input-token pricing tiers for long-context cost accounting.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.80.6 https://github.com/earendil-works/pi.git
$ git checkout v0.80.6
└──▷ TRY IT
Invoke the highest reasoning depth on a complex refactor task when using GPT-5.6 or a supported Claude model.
copy
$ pi --thinking max 'Audit this codebase for insecure deserialization patterns and propose fixes'
Adds max thinking level (above xhigh) for GPT-5.6 and adaptive Claude models, available via CLI, SDK, RPC RPC Remote Procedure Call, a protocol that lets a program execute a function on another machine as if it were local, giving cyber tools a structured way to communicate across processes or hosts without managing raw sockets. , and model selection; custom themes can define thinkingMax. Not checked yet Adds request-wide input-token pricing tiers for accurate long-context cost accounting (e.g. GPT-5.4/5.5/5.6 rates), configurable in models.json and modelOverrides. Not checked yet Supports ~ (home directory) expansion in the shellPath setting. Not checked yet
3 details in Everything
Pi v0.80.3 adds Claude Sonnet 5, Azure Foundry endpoints, new RPC RPC Remote Procedure Call, a protocol that lets a program execute a function on another machine as if it were local, giving cyber tools a structured way to communicate across processes or hosts without managing raw sockets. session APIs, and configurable editor/padding settings.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.80.3 https://github.com/earendil-works/pi.git
$ git checkout v0.80.3
└──▷ USE IT
Override the Ctrl+G external editor to use a specific binary (e.g. vim) instead of the environment default.
json
copy
// In settings.json
{ "externalEditor": "vim" }
Tighten or expand terminal padding for assistant and thinking output to improve readability in narrow or wide terminals.
json
copy
// In settings.json
{ "outputPad": 4 }
Adds Anthropic Claude Sonnet 5 support via Anthropic-compatible and Bedrock provider catalogs, with adaptive thinking enabled. Not checked yet Supports modern Microsoft Azure Foundry endpoint URLs for the Azure OpenAI Responses provider. Not checked yet New get_entries and get_tree RPC commands let clients inspect session entries and tree snapshots programmatically. Not checked yet New ./rpc-entry package export enables launching Pi directly in RPC mode. Not checked yet New session_info_changed extension event lets extensions observe session name changes. Not checked yet
+4 more
show less
New externalEditor setting configures a preferred editor for Ctrl+G, overriding $VISUAL/$EDITOR fallbacks. Not checked yet New outputPad setting controls horizontal padding for user messages, assistant messages, and thinking blocks. Not checked yet Adds Usage.reasoning token counts for providers that report reasoning/thinking token usage. Not checked yet Changes the default OpenAI model to gpt-5.5. Not checked yet
9 details in Everything
└──▷ BREAKING ON UPGRADE
! The default OpenAI model is changed to gpt-5.5.
Pi v0.80.0 adds Ctrl+J newline keybinding and migrates pi-ai's global API to a new compat entrypoint.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.80.0 https://github.com/earendil-works/pi.git
$ git checkout v0.80.0
Adds Ctrl+J as a default newline keybinding alongside Shift+Enter . Not checked yet Moves pi-ai's legacy global API (stream/complete/completeSimple, getModel/getModels/getProviders, registerApiProvider, getEnvApiKey, etc.) from the @earendil-works/pi-ai root to @earendil-works/pi-ai/compat; extension sources typechecking against pi-ai's published types should update imports accordingly or migrate to the new createModels() /provider-factory API. Not checked yet Removes the @earendil-works/pi-ai/base and @earendil-works/pi-agent-core/base selective-provider entrypoints; use the root packages with explicit Models provider factories instead. Not checked yet
3 details in Everything
└──▷ BREAKING ON UPGRADE
! The @earendil-works/pi-ai/base and @earendil-works/pi-agent-core/base entrypoints have been removed; use the root packages with explicit Models provider factories instead.! The global API (stream/complete/completeSimple, getModel/getModels/getProviders, registerApiProvider, getEnvApiKey, etc.) has been moved off the @earendil-works/pi-ai root entrypoint to @earendil-works/pi-ai/compat; extension sources that typecheck against pi-ai's published types must switch those imports to @earendil-works/pi-ai/compat or migrate to the new createModels() /provider-factory API.
Extension compaction events gain reason/willRetry context; pi update now pins the exact checked version.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.79.10 https://github.com/earendil-works/pi.git
$ git checkout v0.79.10
└──▷ USE IT
React differently in a custom summarization extension depending on whether compaction was triggered manually, by a threshold, or as an overflow retry.
javascript
copy
// In your extension handler:
extension.on('session_before_compact', ({ reason, willRetry }) => {
if (reason === 'overflow' && willRetry) {
// overflow retry: use a lighter summary to reduce token cost
} else if (reason === 'manual') {
// user-initiated /compact: run full archival summary
}
});
Adds reason and willRetry metadata to session_before_compact and session_compact extension events, enabling extensions to distinguish manual /compact, threshold auto-compaction, and overflow retry flows. Not checked yet Updates pi update to install the exact version returned by the Pi update check and surface the changelog URL in update notices, making upgrade behavior predictable. Not checked yet
2 details in Everything
Pi v0.79.9 adds chat-template thinking support for vLLM/Hugging Face providers like DeepSeek and improves GLM-5.2 routing.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.79.9 https://github.com/earendil-works/pi.git
$ git checkout v0.79.9
Adds chat-template thinking support: OpenAI-compatible custom providers can now map Pi thinking levels into chat_template_kwargs, enabling vLLM/Hugging Face models such as DeepSeek to use provider-native thinking controls. Not checked yet Enables GLM-5.2 xhigh reasoning on OpenRouter OpenRouter A unified API gateway that routes requests to dozens of LLM providers under one endpoint, letting cyber tools swap or compare models without rewriting provider-specific integration code. and corrects Fireworks routing to use the OpenAI-compatible Chat Completions endpoint with reasoning_effort support. Not checked yet
2 details in Everything
Pi v0.79.8 adds Mistral prompt caching, OpenRouter OpenRouter A unified API gateway that routes requests to dozens of LLM providers under one endpoint, letting cyber tools swap or compare models without rewriting provider-specific integration code. Fusion alias, and post-compaction token estimates.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.79.8 https://github.com/earendil-works/pi.git
$ git checkout v0.79.8
Adds Mistral prompt caching using the Pi session ID as the cache key, with cached-token usage and cost accounting surfaced per session. Not checked yet Adds openrouter/fusion as a built-in OpenRouter model alias for direct use as a provider target. Not checked yet Adds estimated post-compaction token counts to compact results and compaction events, letting clients display approximate context reduction. Not checked yet Adds @earendil-works/pi-ai/base and @earendil-works/pi-agent-core/base entry points for SDK users who need selective provider registration to trim bundle size. Not checked yet
4 details in Everything
Pi v0.79.7 adds automatic light/dark theme switching, scoped update control, and new extension API exports.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.79.7 https://github.com/earendil-works/pi.git
$ git checkout v0.79.7
└──▷ TRY IT
Update pi and all extensions in one shot when you want everything on the latest version.
Adds automatic theme mode in /settings to assign separate light and dark themes that follow terminal color-scheme changes. Not checked yet Changes pi update to update only pi by default; new pi update --all updates pi and all extensions together. Not checked yet Exports generateDiffString, generateUnifiedPatch, and EditDiffResult from the public API for extensions that produce edit-style diffs. Not checked yet Enables inline image rendering in Warp terminals via automatic Kitty graphics protocol Kitty graphics protocol A terminal graphics protocol created by the Kitty terminal emulator project that lets applications render pixel-accurate images directly inside a terminal, giving cyber tools rich visual output without a GUI. detection. Not checked yet
4 details in Everything
└──▷ BREAKING ON UPGRADE
! The pi update command now updates only pi itself; the previous behaviour of updating pi and packages together now requires pi update --all.
Pi v0.79.5 adds provider-scoped API key env overrides, a global HTTP proxy setting, and Vercel AI Gateway attribution headers.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.79.5 https://github.com/earendil-works/pi.git
$ git checkout v0.79.5
└──▷ USE IT
Route all Pi AI provider traffic through a corporate proxy without setting shell environment variables.
json
copy
# In Pi global settings (e.g. ~/.config/pi/settings.json)
{
"httpProxy": "http://proxy.corp.example.com:8080"
}
Scope Bedrock credentials and a custom endpoint to Pi only, keeping your shell environment clean.
json
copy
# In auth.json
{
"apiKeys": [
{
"provider": "amazon-bedrock",
"env": {
"AWS_ACCESS_KEY_ID": "AKIA...",
"AWS_SECRET_ACCESS_KEY": "secret",
"AWS_REGION": "us-east-1"
}
}
]
}
Adds provider-scoped env overrides in auth.json API key entries for Cloudflare, Azure OpenAI, Google Vertex, Amazon Bedrock, cache retention, and proxy settings — scoped to Pi without touching the project shell. Not checked yet Adds a global httpProxy setting that propagates HTTP_PROXY and HTTPS_PROXY to all Pi-managed HTTP clients. Not checked yet Adds http-referer and x-title attribution headers to Vercel AI Gateway requests by default. Not checked yet Adds an xp footer marker in the UI when experimental features are enabled. Not checked yet
4 details in Everything
Pi v0.79.4 adds automatic dark/light theme detection on first run and SHA256 SHA256 A cryptographic hash function that turns data into a fixed 256-bit fingerprint. It is used to check integrity; hashing does not encrypt the original data. checksums for standalone binary verification.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.79.4 https://github.com/earendil-works/pi.git
$ git checkout v0.79.4
Adds automatic first-run theme selection: pi detects the terminal background and defaults to the dark or light theme. Not checked yet Adds SHA256SUMS integrity files to GitHub release assets for verifying standalone binary downloads. Not checked yet
2 details in Everything
Pi v0.79.2 adds an experimental first-time setup flow with theme selection and opt-in analytics behind PI_EXPERIMENTAL=1.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.79.2 https://github.com/earendil-works/pi.git
$ git checkout v0.79.2
└──▷ TRY IT
Trigger the first-time setup flow to configure theme and analytics on a fresh install or new agent directory.
copy
$ PI_EXPERIMENTAL=1 pi
Pi v0.79.1 adds Claude Fable 5 support, prompt template defaults, configurable project trust, and extension autocomplete triggers.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.79.1 https://github.com/earendil-works/pi.git
$ git checkout v0.79.1
└──▷ TRY IT
Use a prompt template with an optional positional argument that falls back to a default when not supplied.
copy
$ pi run my-template.md 'custom-value' # passes arg 1; omit it to get the ${1:-7} default
Adds Claude Fable 5 model support on Anthropic and Amazon Bedrock providers, including adaptive thinking and xhigh effort. Not checked yet Supports default positional arguments in prompt templates, e.g. ${1:-7} for optional values. Not checked yet New global defaultProjectTrust setting controls whether unresolved project trust asks, always trusts, or never trusts by default. Not checked yet Extensions can now inspect effective trust decisions via ctx.isProjectTrusted() , including temporary trust. Not checked yet Extension autocomplete providers can declare trigger characters (e.g. # or $) to surface suggestions without slash-command prefixes. Not checked yet
+1 more
show less
Adds areExperimentalFeaturesEnabled feature guard for users to opt in to early features. Not checked yet
6 details in Everything
Pi v0.79.0 adds project trust gating with --approve controls, extension-driven trust decisions, and cache-hit visibility in the footer.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.79.0 https://github.com/earendil-works/pi.git
$ git checkout v0.79.0
└──▷ TRY IT
Run Pi in CI or a script without interactive trust prompts, auto-approving all project-local resources.
Run Pi in an environment where you want to block all project-local resources without any prompt.
Adds project trust gating: Pi now prompts before loading project-local settings, resources, instructions, and packages, with --approve / --no-approve flags for non-interactive automation. Not checked yet Adds project_trust extension event so global and CLI extensions can decide, remember, or defer trust decisions before project-local resources load. Not checked yet Adds prompt cache hit rate (CH) display to the interactive footer for real-time cache visibility. Not checked yet Exports RPC RPC Remote Procedure Call, a protocol that lets a program execute a function on another machine as if it were local, giving cyber tools a structured way to communicate across processes or hosts without managing raw sockets. extension UI request/response types and coding-agent package asset path helpers from the public SDK API. Not checked yet
4 details in Everything
Pi v0.78.1 adds Ant Ling, NVIDIA NIM, and MiniMax-M3 provider support plus richer extension context APIs.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.78.1 https://github.com/earendil-works/pi.git
$ git checkout v0.78.1
└──▷ USE IT
Adapt an extension's behavior based on whether Pi is running in TUI TUI A text-based user interface that runs inside a terminal, using characters and ANSI escape codes to render menus, panes, and widgets without a graphical desktop, letting cyber tools ship rich interactivity with no GUI dependency. , RPC RPC Remote Procedure Call, a protocol that lets a program execute a function on another machine as if it were local, giving cyber tools a structured way to communicate across processes or hosts without managing raw sockets. , JSON, or print mode — for example, suppressing interactive prompts in JSON mode JSON mode Forcing a model's response to match a given format or JSON schema, so software can parse it reliably instead of hoping the text is well formed. .
javascript
copy
// Inside an extension command handler
if (ctx.mode === 'json') {
// emit structured output only
} else {
// render rich TUI output
}
Inspect the current base system prompt inputs from within an extension command to tailor or augment the prompt context.
javascript
copy
// Inside an extension command handler
const promptOptions = ctx.getSystemPromptOptions();
console.log(promptOptions);
Adds Ant Ling provider selection and setup support. Not checked yet Adds NVIDIA NIM provider selection, setup, and direct NIM request attribution headers. Not checked yet Adds MiniMax-M3 model support for the minimax and minimax-cn direct providers. Not checked yet Adds ctx.mode to extension contexts so extensions can distinguish TUI, RPC, JSON, and print modes. Not checked yet Adds ctx.getSystemPromptOptions() for extension commands to inspect current base system prompt inputs. Not checked yet
+1 more
show less
Adds containerization documentation and a Gondolin extension example for routing built-in tools into a local micro-VM. Not checked yet
6 details in Everything
Pi v0.78.0 adds named sessions, clickable file paths, custom Bedrock headers, and new extension APIs.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.78.0 https://github.com/earendil-works/pi.git
$ git checkout v0.78.0
└──▷ TRY IT
Label a session so it's identifiable by name in session listings or logs from the moment it starts.
copy
$ pi --name incident-triage-2025
Start a non-interactive print-mode session with a meaningful name for audit trail purposes.
copy
$ pi -n vuln-scan-run --print 'Scan the repo for hardcoded secrets'
Adds --name / -n flag to set a session display name at startup across interactive, print, JSON, and RPC RPC Remote Procedure Call, a protocol that lets a program execute a function on another machine as if it were local, giving cyber tools a structured way to communicate across processes or hosts without managing raw sockets. modes. Not checked yet Adds OSC 8 file:// hyperlinks to file paths in built-in file tool titles, including tmux clients that support them. Not checked yet Adds custom Amazon Bedrock request header support. Not checked yet Exports convertToPng for extension authors. Not checked yet Exports parseArgs and type Args for extension authors. Not checked yet
+1 more
show less
Shows a resume command hint when exiting interactive sessions. Not checked yet
6 details in Everything
Pi v0.77.0 adds selective tool disablement, headless Codex device-code login, streaming-aware extension input, and Claude Opus 4.8 support.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.77.0 https://github.com/earendil-works/pi.git
$ git checkout v0.77.0
└──▷ TRY IT
Disable a noisy or risky built-in tool (e.g., bash execution) for a scoped review session without touching your config.
copy
$ pi --exclude-tools bash
Adds --exclude-tools / -xt flag to disable specific built-in, extension, or custom tools while keeping all others active. Not checked yet Adds device-code auth for headless ChatGPT Plus/Pro Codex subscription login via /login. Not checked yet Adds InputEvent.streamingBehavior so extensions can distinguish idle prompts, mid-stream steers, and queued follow-ups. Not checked yet Adds Claude Opus 4.8 model metadata and updated adaptive-thinking coverage for Anthropic. Not checked yet
4 details in Everything
Pi v0.76.0 adds explicit session IDs for automation, RPC RPC Remote Procedure Call, a protocol that lets a program execute a function on another machine as if it were local, giving cyber tools a structured way to communicate across processes or hosts without managing raw sockets. bash context exclusion, and configurable provider retry limits.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.76.0 https://github.com/earendil-works/pi.git
$ git checkout v0.76.0
└──▷ TRY IT
Resume a named session in a CI script so every run appends to the same conversation history rather than starting fresh.
copy
$ pi --session-id ci-build-session-42 'Check for new lint errors in the diff'
Cap provider retries to avoid long waits on quota errors in automated pipelines.
yaml
copy
# In your Pi settings file:
retry:
provider:
maxRetries: 2
Adds --session-id <id> flag to create or resume an exact project-local session, enabling deterministic session management in scripts and automation. Not checked yet Adds excludeFromContext flag to the RPC bash command so shell output can be kept out of the model's next prompt context. Not checked yet Introduces retry.provider.maxRetries setting to give explicit control over provider-level retries instead of relying on hidden SDK defaults. Not checked yet
3 details in Everything
Pi v0.75.5 adds adaptive thinking for custom Anthropic-compatible providers and cleaner read tool UI.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.75.5 https://github.com/earendil-works/pi.git
$ git checkout v0.75.5
└──▷ USE IT
Enable adaptive thinking on a custom Anthropic-compatible provider so Claude reasons more deeply on complex tasks.
yaml
copy
# In your custom provider model config:
compat:
forceAdaptiveThinking: true
Adds compat.forceAdaptiveThinking option to custom Anthropic-compatible model configs to enable adaptive-thinking Claude behavior on third-party providers. Not checked yet Collapsed read tool cards now show only the read line by default; press Ctrl+O to expand full file content. Not checked yet Adds a standard unified patch to edit tool result details for SDK consumers. Not checked yet
3 details in Everything
Pi v0.75.4 adds supply-chain hardening with shrinkwrap/lifecycle-script controls and interactive post-update changelogs.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.75.4 https://github.com/earendil-works/pi.git
$ git checkout v0.75.4
└──▷ TRY IT
After upgrading, view the new version's changelog inline before resuming work.
Supply-chain hardening: ships npm-shrinkwrap.json for transitive dependency locking, enforces dependency pinning and lifecycle-script allowlists, and disables lifecycle scripts during self-update and local release installs. Not checked yet Shows interactive update notes after pi update so users can review the installed version's changelog before continuing. Not checked yet Exports image resize utilities from the package root for SDK consumers. Not checked yet
3 details in Everything
Pi v0.74.1 adds image generation, Together AI provider, and Windows ARM64 ARM64 A 64-bit CPU architecture from ARM Holdings, used in mobile chips, Apple Silicon, and cloud servers; cyber tools target it to run natively on those platforms instead of relying on emulation. binaries
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.74.1 https://github.com/earendil-works/pi.git
$ git checkout v0.74.1
└──▷ TRY IT
Authenticate with Together AI to start using its models without manual config.
Adds image generation support via OpenRouter OpenRouter A unified API gateway that routes requests to dozens of LLM providers under one endpoint, letting cyber tools swap or compare models without rewriting provider-specific integration code. , including image generation APIs and image model metadata. Not checked yet Adds Together AI as a built-in provider with /login API-key authentication and default model resolution. Not checked yet Adds standalone release binaries for Windows ARM64. Not checked yet Improves terminal markdown rendering with list indentation and task-list checkbox display. Not checked yet
4 details in Everything
Pi v0.73.1 adds self-update npm scope migration support, interactive OAuth login selection, and JSONC-style models.json parsing.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.73.1 https://github.com/earendil-works/pi.git
$ git checkout v0.73.1
└──▷ TRY IT
Migrate an existing global install to the new npm scope without manual uninstall/reinstall steps.
Adds npm scope migration support to pi update --self: uninstalls the old @mariozechner/pi-coding-agent package and installs the renamed @earendil-works/pi-coding-agent package automatically. Not checked yet Enables interactive OAuth login selection so providers can present multiple login choices in /login for provider-specific authentication flows. Not checked yet Supports JSONC-style models.json parsing — comments and trailing commas are now allowed, making custom provider and model configuration easier to maintain. Not checked yet
3 details in Everything
Pi v0.73.0 adds incremental bash streaming, compact read rendering, and Xiaomi MiMo API billing with regional Token Plan providers.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.73.0 https://github.com/earendil-works/pi.git
$ git checkout v0.73.0
Adds Xiaomi MiMo API billing provider (xiaomi) alongside three regional Token Plan providers: xiaomi-token-plan-cn, xiaomi-token-plan-ams, and xiaomi-token-plan-sgp, each defaulting to mimo-v2.5-pro. Not checked yet Streams bash tool output incrementally as commands run, rather than buffering until completion. Not checked yet Collapses Pi docs, AGENTS/CLAUDE context files, and SKILL.md contents by default in interactive read output, showing only selected line ranges. Not checked yet
3 details in Everything
└──▷ BREAKING ON UPGRADE
! The built-in xiaomi provider now uses Xiaomi's API billing endpoint instead of Token Plan AMS; XIAOMI_API_KEY must now be an API billing key from platform.xiaomimimo.com. Users on Token Plan must switch to xiaomi-token-plan-cn, xiaomi-token-plan-ams, or xiaomi-token-plan-sgp and set the corresponding env var (XIAOMI_TOKEN_PLAN_CN_API_KEY, XIAOMI_TOKEN_PLAN_AMS_API_KEY, or XIAOMI_TOKEN_PLAN_SGP_API_KEY).! The /login display name for the built-in Xiaomi provider is renamed from Xiaomi MiMo Token Plan to Xiaomi MiMo .
Pi v0.72.0 adds Xiaomi MiMo provider, per-model base URL overrides, and a post-turn agent stop callback.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.72.0 https://github.com/earendil-works/pi.git
$ git checkout v0.72.0
Adds Xiaomi MiMo Token Plan as an Anthropic-compatible provider, authenticated via XIAOMI_API_KEY, with default model mimo-v2.5-pro and /login display support. Not checked yet Introduces thinkingLevelMap for model definitions, letting models declare exactly which thinking levels they support (replacing reasoningEffortMap). Not checked yet Enables per-model baseUrl overrides in pi.registerProvider() model definitions. Not checked yet Adds shouldStopAfterTurn callback to the agent loop, allowing graceful exit after a completed turn. Not checked yet
4 details in Everything
└──▷ BREAKING ON UPGRADE
! compat.reasoningEffortMap in models.json and pi.registerProvider() model definitions is replaced by model-level thinkingLevelMap; existing mappings must be migrated from compat.reasoningEffortMap to thinkingLevelMap.
Pi v0.71.1 adds websocket-cached transport for OpenAI Codex, reusing connections and sending only new conversation items.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.71.1 https://github.com/earendil-works/pi.git
$ git checkout v0.71.1
Pi v0.71.0 adds Cloudflare AI Gateway and Moonshot AI providers, Mistral Medium 3.5, and new extension APIs.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.71.0 https://github.com/earendil-works/pi.git
$ git checkout v0.71.0
└──▷ TRY IT
Pin session storage to a specific directory without passing a flag every invocation, useful in CI or containerised workflows.
copy
$ PI_CODING_AGENT_SESSION_DIR=/var/pi/sessions pi
Adds Cloudflare AI Gateway as a built-in provider, configured via CLOUDFLARE_API_KEY, CLOUDFLARE_ACCOUNT_ID, and CLOUDFLARE_GATEWAY_ID. Not checked yet Adds Moonshot AI as a built-in provider, configured via MOONSHOT_API_KEY. Not checked yet Adds built-in support for the Mistral Medium 3.5 model. Not checked yet Adds PI_CODING_AGENT_SESSION_DIR environment variable as an equivalent to --session-dir for configuring session storage. Not checked yet Extension APIs can now replace finalized message_end messages, enabling overrides of assistant usage cost reporting. Not checked yet
+4 more
show less
Adds ctx.ui.getEditorComponent() so extensions can wrap the currently configured custom editor factory. Not checked yet Adds a thinking_level_select extension event for observing thinking level changes. Not checked yet Adds top-level name support to pi.registerProvider() so extension-registered providers display a friendly name in /login. Not checked yet Exposes routed OpenAI-compatible response model metadata in assistant messages so providers like OpenRouter OpenRouter A unified API gateway that routes requests to dozens of LLM providers under one endpoint, letting cyber tools swap or compare models without rewriting provider-specific integration code. can surface the concrete model used. Not checked yet
9 details in Everything
└──▷ BREAKING ON UPGRADE
! Built-in Google Gemini CLI and Google Antigravity providers have been removed; existing configurations using those providers must switch to another supported provider.
Pi v0.70.6 adds Cloudflare Workers AI as a built-in provider with API key, default model, and /login support.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.70.6 https://github.com/earendil-works/pi.git
$ git checkout v0.70.6
Pi v0.70.3 adds self-update via pi update, Azure Cognitive Services endpoint support, and new extension APIs for custom working-state UI.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.70.3 https://github.com/earendil-works/pi.git
$ git checkout v0.70.3
└──▷ TRY IT
Keep Pi itself current without separately managing the binary — run one command to update both Pi and all installed packages.
Adds self-update capability to pi update so Pi itself can be upgraded alongside installed packages. Not checked yet Adds Azure Cognitive Services endpoint support for Azure OpenAI Responses deployments. Not checked yet Adds warnings.anthropicExtraUsage setting in /settings to suppress the Anthropic extra-usage billing warning. Not checked yet Adds ctx.ui.setWorkingVisible() extension API, enabling extensions to hide the built-in loader row and render a custom working state. Not checked yet
4 details in Everything
Pi v0.70.1 adds DeepSeek provider support and configurable provider timeout/retry controls.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.70.1 https://github.com/earendil-works/pi.git
$ git checkout v0.70.1
└──▷ USE IT
Tune timeout and retries for a slow local inference endpoint so long-running requests don't bail out prematurely.
ini
copy
retry.provider.timeoutMs = 120000
retry.provider.maxRetries = 5
retry.provider.maxRetryDelayMs = 10000
Adds DeepSeek provider with V4 Flash/Pro models, authenticated via DEEPSEEK_API_KEY. Not checked yet New retry.provider.{timeoutMs,maxRetries,maxRetryDelayMs} settings expose per-provider timeout and retry controls, useful for long-running local inference. Not checked yet
2 details in Everything
Pi v0.70.0 adds GPT-5.5 Codex support, fuzzy auth-provider search, auth source labels, and granular built-in tool disabling.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.70.0 https://github.com/earendil-works/pi.git
$ git checkout v0.70.0
└──▷ TRY IT
Launch a session that suppresses all built-in tools but still allows your custom extensions to run.
copy
$ pi --no-builtin-tools
Re-enable OSC 9;4 progress bars in terminals that support them after the default changed to off.
📍 In the Pi TUI, open /settings and set terminal.showTerminalProgress to true
Adds openai-codex/gpt-5.5 as a model option with xhigh reasoning support and priority-tier pricing. Not checked yet Adds fuzzy search/filtering to the /login provider selector, making it faster to find providers when many are configured. Not checked yet Adds auth source labels in /login showing whether credentials come from --api-key, an environment variable, or a custom provider fallback — without exposing secrets. Not checked yet Adds --no-builtin-tools CLI flag and createAgentSession({ noTools: "builtin" }) SDK option to disable only built-in tools while keeping extension tools active. Not checked yet Adds opt-in OSC 9;4 terminal progress indicators, toggled via terminal.showTerminalProgress in /settings. Not checked yet
5 details in Everything
└──▷ BREAKING ON UPGRADE
! OSC 9;4 terminal progress indicators are now disabled by default; set terminal.showTerminalProgress to true in /settings to re-enable.
Pi v0.69.0 adds stacked autocomplete providers, terminating tool results, and OSC 9;4 progress indicators.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.69.0 https://github.com/earendil-works/pi.git
$ git checkout v0.69.0
└──▷ USE IT
Layer a custom GitHub issue autocomplete provider on top of built-in slash/path completion in an extension.
typescript
copy
ctx.ui.addAutocompleteProvider(myGithubIssueProvider);
Return a final structured result from a tool without paying for an extra LLM LLM A large language model, a neural network trained on large amounts of text to recognize patterns and generate language. Applications use it for tasks such as answering, summarizing and writing code. turn.
typescript
copy
return { result: myOutput, terminate: true };
Adds ctx.ui.addAutocompleteProvider(...) so extensions can stack custom completion logic on top of built-in slash and path completion. Not checked yet Supports terminate: true on tool results, letting custom tools end a tool batch without triggering an automatic follow-up LLM call. Not checked yet Adds OSC 9;4 terminal progress indicators during agent streaming and compaction for terminals that support tab-bar activity display (iTerm2, WezTerm, Windows Terminal, Kitty). Not checked yet Migrates extension SDK to TypeBox 1.x with native tool argument validation that works in eval-restricted runtimes such as Cloudflare Workers. Not checked yet
4 details in Everything
└──▷ BREAKING ON UPGRADE
! Extensions and SDK integrations must now depend on and import from typebox 1.x instead of @sinclair/typebox 0.34.x; @sinclair/typebox/compiler is no longer shimmed.! After ctx.newSession() , ctx.fork() , or ctx.switchSession() , pre-replacement session-bound extension objects (including captured pi and command ctx references) are invalidated and now throw instead of silently targeting the replaced session; post-switch work must be moved into the withSession callback using the provided ReplacedSessionContext.
Pi v0.68.1 adds Fireworks AI provider support and configurable inline tool image width.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.68.1 https://github.com/earendil-works/pi.git
$ git checkout v0.68.1
└──▷ HOW TO FIND IT
Widen tool-output images in the terminal to avoid them being clipped at the default size.
📍 In Pi, run /settings and set terminal.imageWidthCells to your desired cell width (e.g. 120).
Adds built-in Fireworks provider with FIREWORKS_API_KEY auth and default model accounts/fireworks/models/kimi-k2p6. Not checked yet Adds configurable inline tool image width via terminal.imageWidthCells in /settings. Not checked yet
2 details in Everything
Pi v0.68.0 adds /clone, configurable keybindings, extension working-indicator control, and richer session_shutdown metadata.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.68.0 https://github.com/earendil-works/pi.git
$ git checkout v0.68.0
└──▷ TRY IT
Duplicate your current session branch into a new session to experiment without losing the original conversation state.
Bind the OAuth callback server to a non-loopback interface when pi auth runs inside a container or remote dev environment.
copy
$ PI_OAUTH_CALLBACK_HOST=0.0.0.0 pi auth
New /clone command duplicates the current active branch into a fresh session, complementing /fork which targets a previous user message. Not checked yet Extensions can now control the streaming working indicator (animated frames, static, or hidden) via ctx.ui.setWorkingIndicator() . Not checked yet before_agent_start extension events now expose systemPromptOptions (BuildSystemPromptOptions) so extensions can inspect structured system-prompt inputs directly. Not checked yet ctx.fork() gains a position: "before" | "at" option so extensions can branch before a user message or duplicate the current conversation point. Not checked yet Keybindings for scoped model-selector actions and session-tree filter actions are now remappable via keybindings.json. Not checked yet
+3 more
show less
New PI_OAUTH_CALLBACK_HOST environment variable lets the built-in OAuth login flow (pi auth) bind its local callback server to a custom interface instead of hardcoded 127.0.0.1. Not checked yet session_shutdown extension events now carry reason and targetSessionFile metadata, enabling extensions to distinguish quit, reload, new-session, resume, and fork teardown paths. Not checked yet pi update now batches npm package updates per scope and runs git package updates with bounded parallelism, significantly reducing multi-package update time. Not checked yet
8 details in Everything
└──▷ BREAKING ON UPGRADE
! createAgentSession({ tools }) now expects string[] names such as "read" and "bash" instead of Tool[] instances; migrate SDK code from tools: [readTool, bashTool] to tools: ["read", "bash"].! --tools now allowlists built-in, extension, and custom tools by name, and --no-tools now disables all tools by default rather than only built-ins.! Prebuilt cwd-bound tool exports (readTool, bashTool, editTool, writeTool, grepTool, findTool, lsTool, readOnlyTools, codingTools) and their corresponding *ToolDefinition values have been removed from @mariozechner/pi-coding-agent; use explicit factory exports such as createReadTool(cwd) , createBashTool(cwd) , createCodingTools(cwd) , and createReadToolDefinition(cwd) instead.! DefaultResourceLoader, loadProjectContextFiles() , and loadSkills() no longer fall back to process.cwd() / a default agent-dir; an explicit cwd is now required and exported system-prompt option types enforce it.
Pi v0.67.67 adds AWS bearer-token auth for Bedrock Converse API, removing the SigV4 SigV4 AWS's request-signing protocol that authenticates HTTP calls by hashing the request body, headers, and credentials into a signature; cyber tools use it to talk to AWS APIs without embedding long-lived secrets. credential requirement.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.67.67 https://github.com/earendil-works/pi.git
$ git checkout v0.67.67
Supports AWS_BEARER_TOKEN_BEDROCK environment variable to authenticate Bedrock sessions via the Converse API without local SigV4 credentials. Not checked yet
1 detail in Everything
Pi v0.67.6 adds prompt template argument hints, a new extension hook for HTTP response inspection, and OSC 8 hyperlink rendering.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.67.6 https://github.com/earendil-works/pi.git
$ git checkout v0.67.6
└──▷ USE IT
Document required and optional arguments on a prompt template so users see hints in the / autocomplete dropdown.
yaml
copy
---
name: summarize
argument-hint: <file> [max-words]
description: Summarize a file
---
Summarize the contents of {{file}} in at most {{max-words}} words.
Adds argument-hint frontmatter field for prompt templates, displayed before the description in the / autocomplete dropdown using <angle> for required and [square] for optional arguments. Not checked yet New after_provider_response extension hook lets extensions inspect provider HTTP status codes and headers after each response is received and before stream consumption begins. Not checked yet Compact interactive startup header now shows loaded AGENTS.md files, prompt templates, skills, and extensions as a comma-separated list; press Ctrl+O to toggle the expanded view. Not checked yet Markdown links in assistant output render as OSC 8 hyperlinks on supporting terminals, with safe fallback to plain text on unknown terminals and tmux/screen. Not checked yet
4 details in Everything
Pi v0.67.4 adds --no-context-files flag, exportable context-file utility, new extension hook, and claude-opus-4-7 model support.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.67.4 https://github.com/earendil-works/pi.git
$ git checkout v0.67.4
└──▷ TRY IT
Run Pi without injecting any AGENTS.md or CLAUDE.md context files — useful in CI or when testing a prompt in isolation.
copy
$ pi --no-context-files "Explain what this repo does"
Use the exported utility inside an extension to discover project context files using the same resolution order as the CLI.
javascript
copy
import { loadProjectContextFiles } from 'pi';
const files = await loadProjectContextFiles(process.cwd());
console.log('Context files found:', files);
New --no-context-files (-nc) flag disables automatic AGENTS.md / CLAUDE.md discovery for clean runs without project context injection. Not checked yet Exports loadProjectContextFiles() as a standalone utility for extensions and SDK-style integrations to inspect context-file resolution order. Not checked yet New after_provider_response extension hook enables extensions to inspect provider HTTP status codes and headers after each response and before stream consumption. Not checked yet Adds claude-opus-4-7 model for Anthropic provider. Not checked yet Anthropic prompt caching now adds a cache_control breakpoint on the last tool definition, enabling tool schemas to be cached independently from transcript updates. Not checked yet
5 details in Everything
Pi v0.67.3 adds renderShell: "self" for tool renderers to own their outer shell and live backoff countdowns on auto-retry.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.67.3 https://github.com/earendil-works/pi.git
$ git checkout v0.67.3
└──▷ USE IT
Use renderShell: "self" in an extension renderer so your tool's diff preview fills its own shell without the default box wrapper.
yaml
copy
renderShell: "self"
New renderShell: "self" option for custom and built-in tool renderers lets tools own their outer shell instead of the default boxed shell, enabling stable large previews such as edit diffs. Not checked yet Interactive auto-retry status now displays a live countdown during backoff periods instead of a static retry delay message. Not checked yet
2 details in Everything
Pi v0.67.2 adds multi-flag system prompt appending, Kitty super-key bindings, and inline extension factories for custom entrypoints.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.67.2 https://github.com/earendil-works/pi.git
$ git checkout v0.67.2
└──▷ TRY IT
Layer multiple system prompt fragments at launch — useful when composing role instructions with dynamic context (e.g., rules file + live asset list) without modifying a base config.
copy
$ pi --append-system-prompt "You are a security analyst. Follow OWASP guidelines." --append-system-prompt "Scope: only assess endpoints under /api/v2."
Supports multiple --append-system-prompt flags in a single invocation, with each value appended to the system prompt separated by double newlines. Not checked yet Adds interactive keybinding support for Kitty super-modified shortcuts such as super+k, super+enter, and ctrl+super+k. Not checked yet Supports passing inline extension factories to main() for embedded integrations and custom entrypoints. Not checked yet
3 details in Everything
Pi v0.67.1 adds full OpenRouter OpenRouter A unified API gateway that routes requests to dozens of LLM providers under one endpoint, letting cyber tools swap or compare models without rewriting provider-specific integration code. routing config in models.json and a new env var for subprocess detection.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.67.1 https://github.com/earendil-works/pi.git
$ git checkout v0.67.1
└──▷ USE IT
Route a model through OpenRouter with fallback providers, ZDR, and a max price cap — useful when you need data-residency guarantees or cost control in a shared team setup.
json
copy
# In models.json, add an openRouterRouting block to your model entry:
{
"id": "my-model",
"openRouterRouting": {
"fallbacks": ["openai/gpt-4o", "anthropic/claude-3-5-sonnet"],
"dataCollection": false,
"zdr": true,
"maxPrice": { "prompt": 0.01, "completion": 0.03 },
"order": ["Fireworks", "Together"]
}
}
Detect inside a shell script or tool invoked by Pi that the process is running under the Pi coding agent.
copy
$ if [ "$PI_CODING_AGENT" = "true" ]; then
echo "Running inside Pi coding agent — skipping interactive prompts"
fi
Adds full openRouterRouting field support in models.json, enabling fallbacks, parameter requirements, data collection, ZDR, ignore lists, quantizations, provider sorting, max price, and preferred throughput/latency constraints. Not checked yet Sets PI_CODING_AGENT=true at startup so subprocesses and scripts can detect they are running inside the Pi coding agent. Not checked yet Adds anonymous install/update telemetry ping (only in interactive mode) to count per-version adoption; disable via /settings → Install telemetry , enableInstallTelemetry: false in settings.json, PI_OFFLINE=1, or PI_TELEMETRY=0. Not checked yet
3 details in Everything
Pi v0.67.0 adds full OpenRouter OpenRouter A unified API gateway that routes requests to dozens of LLM providers under one endpoint, letting cyber tools swap or compare models without rewriting provider-specific integration code. routing control in models.json and a PI_CODING_AGENT env flag for subprocess detection.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.67.0 https://github.com/earendil-works/pi.git
$ git checkout v0.67.0
└──▷ TRY IT
Detect from a shell script or subprocess that Pi is orchestrating the run, so you can branch logic accordingly.
copy
$ if [ "$PI_CODING_AGENT" = "true" ]; then
echo "Running inside Pi coding agent — skipping interactive prompts"
fi
Adds full openRouterRouting field support in models.json, enabling fallbacks, parameter requirements, data collection, ZDR, ignore lists, quantizations, provider sorting, max price, and preferred throughput/latency constraints. Not checked yet Sets PI_CODING_AGENT=true environment variable at startup so subprocesses and scripts can detect they are running inside the coding agent. Not checked yet Adds lightweight anonymous install/update telemetry ping to track per-version adoption; controllable via /settings, enableInstallTelemetry in settings.json, PI_OFFLINE=1, or PI_TELEMETRY=0. Not checked yet
3 details in Everything
Pi v0.66.0 adds an Earendil startup announcement with inline image rendering and an Anthropic subscription billing warning.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.66.0 https://github.com/earendil-works/pi.git
$ git checkout v0.66.0
Displays an Earendil startup announcement with bundled inline image rendering and a linked blog post during interactive mode on April 8 and 9, 2026. Not checked yet Shows an interactive warning when Anthropic subscription auth is active, clarifying that third-party Anthropic usage draws from extra usage and is billed per token. Not checked yet
2 details in Everything
Pi v0.65.0 adds a session runtime API, defineTool() helper, tree timestamps, and unified structured diagnostics.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.65.0 https://github.com/earendil-works/pi.git
$ git checkout v0.65.0
└──▷ TRY IT
Toggle timestamps on session tree entries to audit when branches were created without leaving the TUI TUI A text-based user interface that runs inside a terminal, using characters and ANSI escape codes to render menus, panes, and widgets without a graphical desktop, letting cyber tools ship rich interactivity with no GUI dependency. .
copy
$ # Inside the /tree view, press Shift+T to show or hide timestamps on each entry.
Use createAgentSessionRuntime() to manage session lifecycle (new, switch, fork) with cwd-bound service recreation in an SDK integration.
typescript
copy
import {
type CreateAgentSessionRuntimeFactory,
createAgentSessionFromServices,
createAgentSessionRuntime,
createAgentSessionServices,
getAgentDir,
SessionManager,
} from "@mariozechner/pi-coding-agent";
const createRuntime: CreateAgentSessionRuntimeFactory = async ({ cwd, sessionManager, sessionStartEvent }) => {
const services = await createAgentSessionServices({ cwd });
return {
...(await createAgentSessionFromServices({ services, sessionManager, sessionStartEvent })),
services,
diagnostics: services.diagnostics,
};
};
const runtime = await createAgentSessionRuntime(createRuntime, {
cwd: process.cwd(),
agentDir: getAgentDir(),
sessionManager: SessionManager.create(process.cwd()),
});
await runtime.newSession();
await runtime.fork("entry-id");
New createAgentSessionRuntime() and AgentSessionRuntime SDK API: closure-based runtime that recreates cwd-bound services and session config on every session switch, used consistently across startup, /new, /resume, /fork, and import. Not checked yet New defineTool() helper: create standalone custom tool definitions with full TypeScript parameter type inference, eliminating manual casts. Not checked yet Label timestamps in /tree: toggle timestamps on session tree entries with Shift+T , with smart date formatting and preservation through branching. Not checked yet Unified structured diagnostics: arg parsing, service creation, session option resolution, and resource loading now return info/warning/error diagnostics instead of logging or exiting, letting the app layer control presentation and exit behavior. Not checked yet Error diagnostics now reported for missing explicit CLI resource paths (-e, --skill, --prompt-template, --theme). Not checked yet
5 details in Everything
└──▷ BREAKING ON UPGRADE
! Extension post-transition events session_switch and session_fork are removed; use session_start with event.reason ("startup" | "reload" | "new" | "resume" | "fork") and event.previousSessionFile (set for "new", "resume", "fork").! Session-replacement methods (newSession() , switchSession() , fork() , importFromJsonl() ) are removed from AgentSession; use AgentSessionRuntime instead.! session_directory is removed from extension and settings APIs.! Unknown single-dash CLI flags (e.g. -s) now produce an error instead of being silently ignored.
Pi v0.64.0 adds a prepareArguments hook for tool schema migration and lets extensions customize the thinking block label.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.64.0 https://github.com/earendil-works/pi.git
$ git checkout v0.64.0
└──▷ USE IT
When building an extension that uses chain-of-thought chain-of-thought Intermediate reasoning a model writes out before its final answer. Reasoning models generate it automatically and it is often billed as extra output tokens. , replace the default collapsed thinking label with a domain-specific one.
typescript
copy
export default function myExtension(ctx) {
ctx.ui.setHiddenThinkingLabel("[Reasoning hidden — click to expand]");
}
Adds ToolDefinition.prepareArguments hook so extensions and SDK callers can normalize or migrate raw model arguments before schema validation — enabling compatibility shims for resumed sessions with outdated tool schemas. Not checked yet Built-in edit tool uses prepareArguments to silently fold legacy top-level oldText/newText into edits[] when resuming old sessions. Not checked yet Adds ctx.ui.setHiddenThinkingLabel() so extensions can customize the collapsed thinking block label shown in interactive mode. Not checked yet
3 details in Everything
└──▷ BREAKING ON UPGRADE
! ModelRegistry no longer has a public constructor; direct new ModelRegistry(...) calls no longer compile. SDK callers and tests must use ModelRegistry.create(authStorage, modelsJsonPath?) for file-backed registries or ModelRegistry.inMemory(authStorage) for built-in-only registries.
Pi v0.63.2 adds ctx.signal to ExtensionContext for propagating cancellation into nested model calls and fetch operations.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.63.2 https://github.com/earendil-works/pi.git
$ git checkout v0.63.2
└──▷ TRY IT
Propagate agent turn cancellation into a downstream fetch inside a custom extension handler so it aborts cleanly when the user cancels.
copy
$ // Inside your extension handler
async function myHandler(ctx) {
const response = await fetch('https://api.example.com/data', {
signal: ctx.signal
});
return response.json();
}
Adds gemini-3.1-pro-preview-customtools model support for the google-vertex provider.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.63.1 https://github.com/earendil-works/pi.git
$ git checkout v0.63.1
Pi v0.63.0 adds persistent sessionDir config, multi-edit support, and per-instance TUI TUI A text-based user interface that runs inside a terminal, using characters and ANSI escape codes to render menus, panes, and widgets without a graphical desktop, letting cyber tools ship rich interactivity with no GUI dependency. log files.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.63.0 https://github.com/earendil-works/pi.git
$ git checkout v0.63.0
└──▷ USE IT
Persist session storage to a project-specific directory so you never need to pass --session-dir on the command line.
json
copy
# In your project's settings.json
{
"sessionDir": "/path/to/project/.pi-sessions"
}
Capture a unique log file per pi instance when running multiple sessions in parallel (e.g., in tmux panes or CI jobs).
copy
$ PI_TUI_WRITE_LOG=/var/log/pi pi
Adds sessionDir setting in global and project settings.json to persist session storage location without passing --session-dir on every invocation. Not checked yet Adds multi-edit support to the edit tool, allowing one call to update multiple disjoint regions in the same file matched against the original content. Not checked yet Adds PI_TUI_WRITE_LOG directory path support, writing a unique tui-<timestamp>-<pid>.log per pi instance for debugging multiple concurrent sessions. Not checked yet Adds startup onboarding hint in the interactive header informing users that pi can explain its own features and documentation. Not checked yet
4 details in Everything
└──▷ BREAKING ON UPGRADE
! ModelRegistry.getApiKey(model) is replaced by getApiKeyAndHeaders(model) ; extensions and SDK integrations must now fetch both apiKey and headers per request instead of a single API key.! Deprecated direct model IDs minimax and minimax-cn are removed; pinned model IDs must be updated to MiniMax-M2.7 or MiniMax-M2.7-highspeed.
Pi v0.62.0 adds extensible built-in tool rendering, unified sourceInfo provenance provenance Evidence recording where a software artifact came from and how it was built, including its source and build process. It helps a consumer check that the artifact matches a trusted build. , and AWS Bedrock cost allocation tagging.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.62.0 https://github.com/earendil-works/pi.git
$ git checkout v0.62.0
Enables extension authors to override rendering of built-in read/write/edit/bash/grep/find/ls tools with custom renderCall/renderResult components via extensible ToolDefinitions. Not checked yet Adds unified sourceInfo struct (path, scope, source metadata) to all resources, commands, tools, skills, and prompt templates — visible in autocomplete, RPC RPC Remote Procedure Call, a protocol that lets a program execute a function on another machine as if it were local, giving cyber tools a structured way to communicate across processes or hosts without managing raw sockets. discovery, and SDK introspection. Not checked yet New requestMetadata option on BedrockOptions forwards key-value pairs to the Bedrock Converse API for AWS Cost Explorer split cost allocation tagging. Not checked yet
3 details in Everything
└──▷ BREAKING ON UPGRADE
! If renderCall or renderResult is defined on a ToolDefinition, it must now return a Component ; fallback rendering only occurs when no renderer is defined for that slot.! RPC get_commands, RpcSlashCommand, and SDK SlashCommandInfo no longer expose location or path — use sourceInfo instead.! The legacy source fields on Skill and PromptTemplate are removed — use sourceInfo.source instead.! ResourceLoader.getPathMetadata() is removed — resource provenance is now attached directly to loaded resources via sourceInfo.! extensionPath is removed from RegisteredCommand and RegisteredTool — use sourceInfo.path instead.
Pi v0.61.1 adds typed tool_call handler return values and updated default models for zai, cerebras, and MiniMax providers.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.61.1 https://github.com/earendil-works/pi.git
$ git checkout v0.61.1
Adds ToolCallEventResult type exports from @mariozechner/pi-coding-agent top-level and core extension entry points, enabling extension authors to strongly type tool_call handler return values. Not checked yet Updates default models for zai, cerebras, minimax, and minimax-cn providers and adds MiniMax-M2.1-highspeed model entries with normalized context limits. Not checked yet
2 details in Everything
Pi v0.61.0 adds JSONL JSONL A text format where each line is a self-contained, valid JSON object, making it easy to stream, append, and process large datasets line by line without parsing a full JSON array into memory. session export/import, a unified keybinding manager, and gpt-5.4-mini support.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.61.0 https://github.com/earendil-works/pi.git
$ git checkout v0.61.0
└──▷ TRY IT
Preserve a full session to disk for audit, replay, or sharing with a teammate.
copy
$ /export ~/sessions/pentest-2025-07-14.jsonl
Restore a previously saved session — useful for resuming a long engagement or reviewing an archived conversation.
copy
$ /import ~/sessions/pentest-2025-07-14.jsonl
Adds JSONL session export and import via /export <path.jsonl> and /import <path.jsonl> commands. Not checked yet Introduces namespaced keybinding IDs and a unified keybinding manager across the app and TUI TUI A text-based user interface that runs inside a terminal, using characters and ANSI escape codes to render menus, panes, and widgets without a graphical desktop, letting cyber tools ship rich interactivity with no GUI dependency. , with automatic migration of older keybindings.json config files. Not checked yet Adds gpt-5.4-mini to the openai-codex model catalog. Not checked yet Adds a resizable sidebar to HTML share and export views. Not checked yet
4 details in Everything
└──▷ BREAKING ON UPGRADE
! Keybinding IDs in keybindings.json are now namespaced; extension authors must update keyHint() , keyText() , and keybindings.matches(...) calls from old names like "expandTools", "selectConfirm", and "interrupt" to namespaced IDs like "app.tools.expand", "tui.select.confirm", and "app.interrupt". Older config files are migrated automatically on startup.! Custom editors and extension UI components receive an injected keybindings: KeybindingsManager and must not call getKeybindings() or setKeybindings() themselves.
Pi v0.60.0 adds session forking from the CLI and a new createLocalBashOperations() SDK export for custom bash integrations.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.60.0 https://github.com/earendil-works/pi.git
$ git checkout v0.60.0
└──▷ TRY IT
Check for and apply available package updates on demand instead of waiting for a startup auto-update.
Adds --fork <path|id> flag to fork an existing session file or partial session UUID UUID A universally unique identifier, usually a 128-bit value used to identify an object across systems. It is designed to make independently generated identifiers unlikely to collide. into a new session in the current project. Not checked yet Adds createLocalBashOperations() export so extensions and SDK callers can wrap pi's built-in local bash backend for user_bash interception and custom bash integrations. Not checked yet Startup no longer auto-updates unpinned npm and git packages; interactive mode now checks for updates in the background and notifies when newer packages are available. Not checked yet
3 details in Everything
└──▷ BREAKING ON UPGRADE
! Installed unpinned packages are no longer checked or updated during startup — use pi update explicitly to apply npm/git package updates.
Adds pi uninstall as a convenient alias for pi install --uninstall
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.58.1 https://github.com/earendil-works/pi.git
$ git checkout v0.58.1
└──▷ TRY IT
Quickly remove an installed package without typing the full --uninstall flag
copy
$ pi uninstall <package>
Pi v0.58.0 expands Claude Opus/Sonnet 4.6 context to 1M tokens, adds parallel tool execution, and supports GOOGLE_CLOUD_API_KEY for Vertex AI.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.58.0 https://github.com/earendil-works/pi.git
$ git checkout v0.58.0
Raises Claude Opus 4.6, Sonnet 4.6, and related Bedrock model context windows context windows The maximum amount of text, counted in tokens, a model can take in and produce in one request. Everything the model knows about the task has to fit inside it. from 200K to 1M tokens. Not checked yet Enables parallel execution of extension tool calls by default, with sequential tool_call preflight preserved for extension interception. Not checked yet Adds GOOGLE_CLOUD_API_KEY environment variable support for the google-vertex provider as an alternative to Application Default Credentials. Not checked yet Allows extensions to supply deterministic session IDs via newSession() . Not checked yet
4 details in Everything
Pi v0.57.1 adds /tree branch folding, a session_directory extension event, and digit keybindings to the TUI TUI A text-based user interface that runs inside a terminal, using characters and ANSI escape codes to render menus, panes, and widgets without a graphical desktop, letting cyber tools ship rich interactivity with no GUI dependency. .
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.57.1 https://github.com/earendil-works/pi.git
$ git checkout v0.57.1
Adds branch folding and segment-jump navigation in /tree via Ctrl+← /Ctrl+→ (segment jump) and Alt+← /Alt+→ (fold/unfold), alongside existing ←/→ and Page Up /Page Down paging. Not checked yet New session_directory extension event fires before session manager creation, letting extensions customize the session directory path based on cwd or other factors (CLI --session-dir still takes precedence). Not checked yet Digit keys (0-9) now supported in the TUI keybinding system, including modified combos like ctrl+1, with Kitty CSI CSI An ambiguous abbreviation — it most commonly means Container Storage Interface (a Kubernetes storage plugin standard) or Crime Scene Investigation — without more context the correct meaning cannot be determined reliably. -u and xterm modifyOtherKeys protocol support. Not checked yet
3 details in Everything
Pi v0.57.0 adds extension payload interception, non-capturing overlay focus control, and strict JSONL JSONL A text format where each line is a self-contained, valid JSON object, making it easy to stream, append, and process large datasets line by line without parsing a full JSON array into memory. framing in RPC RPC Remote Procedure Call, a protocol that lets a program execute a function on another machine as if it were local, giving cyber tools a structured way to communicate across processes or hosts without managing raw sockets. mode.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.57.0 https://github.com/earendil-works/pi.git
$ git checkout v0.57.0
Adds before_provider_request extension hook so extensions can inspect or replace provider request payloads before they are sent. Not checked yet Enables non-capturing overlays in extension UIs with explicit focus control via OverlayOptions.nonCapturing and OverlayHandle.focus() / unfocus() / isFocused() . Not checked yet RPC mode now uses strict LF-only JSONL framing for more robust payload handling. Not checked yet
3 details in Everything
└──▷ BREAKING ON UPGRADE
! RPC mode now uses strict LF-delimited JSONL framing: clients must split records on \n only and can no longer use generic line readers such as Node readline, which also split on Unicode separators (U+2028, U+2029) inside JSON payloads.
Pi v0.56.3 adds claude-sonnet-4-6 via google-antigravity and improves tmux key support.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.56.3 https://github.com/earendil-works/pi.git
$ git checkout v0.56.3
Adds claude-sonnet-4-6 model support via the google-antigravity provider. Not checked yet Supports Shift+Enter and Ctrl+Enter inside tmux via xterm modifyOtherKeys fallback. Not checked yet
2 details in Everything
Pi v0.56.2 adds GPT-5.4 support, a new treeFilterMode setting, and native Mistral conversations integration.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.56.2 https://github.com/earendil-works/pi.git
$ git checkout v0.56.2
Supports GPT-5.4 across openai, openai-codex, azure-openai-responses, and opencode providers, with gpt-5.4 now the default for openai and openai-codex. Not checked yet Adds gpt-5.3-codex as a fallback model for github-copilot until upstream model catalogs include it. Not checked yet New treeFilterMode setting lets you choose the default /tree filter mode from default, no-tools, user-only, labeled-only, or all. Not checked yet Adds native Mistral conversations integration via the SDK-backed provider, preserving Mistral-specific thinking and replay semantics. Not checked yet
4 details in Everything
└──▷ BREAKING ON UPGRADE
! The default model for the openai and openai-codex providers is now gpt-5.4; any workflow pinned to the previous default will silently switch models on upgrade.
Pi v0.56.0 adds OpenCode Go provider support, a new branch-summary skip setting, and a Gemini flash-lite fallback model.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.56.0 https://github.com/earendil-works/pi.git
$ git checkout v0.56.0
Adds OpenCode Go provider support with opencode-go model defaults and OPENCODE_API_KEY environment variable. Not checked yet New branchSummary.skipPrompt setting suppresses branch summarization prompts during tree navigation. Not checked yet Adds gemini-3.1-flash-lite-preview as a fallback model in Google provider catalogs when upstream metadata lags. Not checked yet
3 details in Everything
└──▷ BREAKING ON UPGRADE
! Scoped model entries without an explicit :<thinking> suffix now inherit the current session thinking level when selected, instead of applying a startup-captured default.! Node OAuth runtime exports are removed from the top-level @mariozechner/pi-ai entry; OAuth login and refresh must now be imported from @mariozechner/pi-ai/oauth.
Pi v0.55.4 adds live tool registration, per-tool system-prompt injection prompt injection An attack where text the model reads, such as a web page, file or tool result, carries instructions that override the user's. It is the main security risk for agents with tools. via promptSnippet and promptGuidelines.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.55.4 https://github.com/earendil-works/pi.git
$ git checkout v0.55.4
└──▷ USE IT
Dynamically register a tool mid-session so the LLM LLM A large language model, a neural network trained on large amounts of text to recognize patterns and generate language. Applications use it for tasks such as answering, summarizing and writing code. can use it immediately without restarting or running /reload.
typescript
copy
pi.registerTool({
name: "lookup",
description: "Look up a value",
promptSnippet: "lookup: fetches live data by key",
promptGuidelines: "Use lookup when the user asks for real-time data.",
execute: async (args) => { /* … */ }
});
Enables runtime tool registration that takes effect immediately in active sessions — tools added via pi.registerTool() are available to pi.getAllTools() and the LLM without /reload. Not checked yet Adds promptSnippet field to ToolDefinition for injecting a one-line entry into the default system prompt's Available tools section while the tool is active. Not checked yet Adds promptGuidelines field to ToolDefinition so active tools can append tool-specific bullets to the default system prompt's Guidelines section. Not checked yet Supports custom tool renderers that suppress transcript output cleanly, leaving no blank rows or empty footprint in interactive rendering. Not checked yet
4 details in Everything
Extensions can now dynamically unregister providers and register them at runtime without requiring /reload.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.55.2 https://github.com/earendil-works/pi.git
$ git checkout v0.55.2
└──▷ TRY IT
Swap in a custom provider at runtime from a command handler and later cleanly remove it, restoring the original built-in models — all without issuing /reload.
copy
$ pi.unregisterProvider("my-custom-provider")
Adds pi.unregisterProvider(name) to dynamically remove a custom provider and its models from the registry, restoring any overridden built-in models. Not checked yet pi.registerProvider() now takes effect immediately when called outside the initial extension load phase (e.g. from a command handler), eliminating the need for /reload after late registrations. Not checked yet
2 details in Everything
Pi v0.55.1 adds offline startup mode and Gemini 3.1 Pro Preview model support.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.55.1 https://github.com/earendil-works/pi.git
$ git checkout v0.55.1
└──▷ TRY IT
Start Pi in an air-gapped or network-restricted environment without waiting on managed-tool network calls.
Adds --offline flag (or PI_OFFLINE env var) to disable startup network operations and avoid hangs in restricted or air-gapped environments. Not checked yet Adds gemini-3.1-pro-preview model support to the google-gemini-cli provider. Not checked yet
2 details in Everything
Pi v0.54.0 adds auto-discovery of agent skills from .agents/skills in project and home directories.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.54.0 https://github.com/earendil-works/pi.git
$ git checkout v0.54.0
Adds automatic skill discovery from .agents/skills in the current directory, ancestor directories (up to git repo root), and ~/.agents/skills globally, alongside existing .pi skill paths. Not checked yet
1 detail in Everything
Pi v0.53.0 adds caller-controlled I/O error draining, pluggable auth storage backends, and a new Claude Sonnet 4-6 model entry.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.53.0 https://github.com/earendil-works/pi.git
$ git checkout v0.53.0
Adds SettingsManager.drainErrors() for caller-controlled settings I/O error handling without manager-side console output. Not checked yet Adds pluggable auth storage backends (FileAuthStorageBackend, InMemoryAuthStorageBackend) and AuthStorage.fromStorage(...) for flexible auth persistence wiring. Not checked yet Adds Anthropic claude-sonnet-4-6 model fallback entry to generated model definitions. Not checked yet
3 details in Everything
└──▷ BREAKING ON UPGRADE
! SettingsManager setters now update in-memory state immediately and queue disk writes — code that requires durable on-disk settings must call await settingsManager.flush() explicitly.! AuthStorage constructor is no longer public — code using new AuthStorage(...) directly will break; use AuthStorage.create(...) , AuthStorage.fromStorage(...) , or AuthStorage.inMemory(...) instead.
Pi v0.52.12 adds a transport setting to choose between SSE SSE Server-Sent Events, a browser API and HTTP-based protocol where a server pushes a stream of text events to a client over a single long-lived connection, giving tools a lightweight alternative to WebSockets for one-way real-time updates. , WebSocket WebSocket A protocol that upgrades an HTTP connection into a persistent, full-duplex channel, letting a server push data to a client without repeated polling. Cyber tools use it for real-time event streaming and live command output. , or auto for supported providers.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.52.12 https://github.com/earendil-works/pi.git
$ git checkout v0.52.12
└──▷ USE IT
Force SSE transport for openai-codex when WebSocket connections are blocked by a proxy.
json
copy
# In settings.json
{
"transport": "sse"
}
New transport setting ("sse", "websocket", "auto") in /settings and settings.json lets you control the connection transport for providers like openai-codex. Not checked yet Interactive mode applies transport changes immediately without restarting the agent session. Not checked yet
2 details in Everything
└──▷ BREAKING ON UPGRADE
! The legacy websockets: boolean setting is migrated to the new transport setting; existing configs using websockets will be remapped automatically.
Pi v0.52.10 adds terminal input interception for extensions, richer --model selection syntax, and new built-in GLM-5 and gpt-5.3-codex-spark models.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.52.10 https://github.com/earendil-works/pi.git
$ git checkout v0.52.10
└──▷ TRY IT
Select a model with a thinking budget suffix without specifying a provider — useful for quickly switching reasoning depth in CI or ad-hoc sessions.
copy
$ pi --model sonnet:high
Target a specific provider and model in one flag when you have multiple providers configured and want deterministic routing.
copy
$ pi --model openai/gpt-4o
Adds terminal_input extension event, letting extensions intercept, consume, or transform raw terminal input before normal TUI TUI A text-based user interface that runs inside a terminal, using characters and ANSI escape codes to render menus, panes, and widgets without a graphical desktop, letting cyber tools ship rich interactivity with no GUI dependency. handling. Not checked yet Adds extension event forwarding for full message and tool execution lifecycles: message_start, message_update, message_end, tool_execution_start, tool_execution_update, tool_execution_end. Not checked yet Expands --model flag to support provider/id syntax, fuzzy matching, and :<thinking> suffixes (e.g., --model sonnet:high, --model openai/gpt-4o) without requiring --provider. Not checked yet Adds built-in gpt-5.3-codex-spark model definition for OpenAI and OpenAI Codex providers Research preview . Not checked yet Adds built-in GLM-5 model support via z.ai and OpenRouter OpenRouter A unified API gateway that routes requests to dozens of LLM providers under one endpoint, letting cyber tools swap or compare models without rewriting provider-specific integration code. provider catalogs. Not checked yet
+1 more
show less
Routes GitHub Copilot Claude 4.x models through the Anthropic Messages API with updated Copilot header handling. Not checked yet
6 details in Everything
└──▷ BREAKING ON UPGRADE
! ContextUsage.tokens and ContextUsage.percent are now number | null; extensions reading these fields must handle the null case after compaction.! The usageTokens, trailingTokens, and lastUsageIndex fields have been removed from ContextUsage; extensions referencing these fields will break.! Git source parsing is now strict: shorthand sources like github.com/org/repo and git@github.com:org/repo no longer work without the git: prefix — only protocol URLs (https://, http://, ssh://, git://) are recognized automatically.
Pi v0.52.9 adds hot-reload for extensions, short disable flag aliases, and richer tool introspection via getAllTools() .
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.52.9 https://github.com/earendil-works/pi.git
$ git checkout v0.52.9
└──▷ USE IT
Trigger a live reload of the Pi runtime from inside an extension — useful when your extension detects a config change and needs to restart the agent without manual intervention.
typescript
copy
ctx.reload();
Launch Pi quickly in a scripting context without loading extensions, skills, or prompt templates.
Introspect all available tools and their full parameter schemas from within an extension to build dynamic dispatch or validation logic.
typescript
copy
const tools = pi.getAllTools();
for (const tool of tools) {
console.log(tool.name, tool.description, tool.parameters);
}
New ctx.reload() extension API method triggers a full runtime reload, enabling hot-reloading of configuration or restarting the agent programmatically. Not checked yet New short CLI aliases -ne, -ns, and -np for --no-extensions, --no-skills, and --no-prompt-templates speed up interactive usage and scripting. Not checked yet Exported /export HTML sessions now include collapsible tool input schemas (parameter names, types, descriptions) for easier session review and sharing. Not checked yet pi.getAllTools() now returns tool parameters in addition to name and description, enabling richer extension integrations. Not checked yet
4 details in Everything
Pi v0.52.8 adds Emacs kill-ring editing, OpenRouter OpenRouter A unified API gateway that routes requests to dozens of LLM providers under one endpoint, letting cyber tools swap or compare models without rewriting provider-specific integration code. auto-routing, and programmatic editor paste for extensions.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.52.8 https://github.com/earendil-works/pi.git
$ git checkout v0.52.8
└──▷ TRY IT
Inspect available subcommands for a package without triggering a silent failure.
copy
$ pi <package> --help
Adds Emacs-style kill ring (ctrl+k/ctrl+y/alt+y) and undo (ctrl+z) keybindings in the editor input. Not checked yet Adds openrouter:auto model alias for automatic OpenRouter model routing. Not checked yet Enables extensions to programmatically paste content into the editor via pasteToEditor in the extension UI context. Not checked yet Adds helpful output for pi <package> --help and invalid subcommands instead of silent failure. Not checked yet
4 details in Everything
└──▷ BREAKING ON UPGRADE
! The default model is changed from Claude Opus 4.5 to Opus 4.6; any workflow pinned to the implicit default will now use Opus 4.6.
Pi v0.52.7 adds per-model config overrides and unauthenticated Bedrock proxy support via new env vars.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.52.7 https://github.com/earendil-works/pi.git
$ git checkout v0.52.7
└──▷ USE IT
Override a specific built-in model's settings (e.g., max tokens) without replacing the whole provider model list.
json
copy
# In models.json
{
"providers": [...],
"modelOverrides": {
"claude-opus-4-5": {
"maxTokens": 8192
}
}
}
Adds modelOverrides key in models.json to customize individual built-in provider models (e.g., context window context window The maximum amount of text, counted in tokens, a model can take in and produce in one request. Everything the model knows about the task has to fit inside it. , parameters) without replacing the entire provider model list. Not checked yet Supports merge-by-id behavior for models.json provider models, letting custom model entries upsert or extend built-ins rather than replacing the full list. Not checked yet Supports unauthenticated Bedrock proxy endpoints via new AWS_BEDROCK_SKIP_AUTH and AWS_BEDROCK_FORCE_HTTP1 environment variables. Not checked yet
3 details in Everything
└──▷ BREAKING ON UPGRADE
! models.json provider models no longer performs full replacement of built-in models — it now merges by id, keeping built-in models by default and upserting custom entries. Any config that relied on models to fully replace a provider's model list will now also include the built-ins.
Pi v0.52.0 adds Claude Opus 4.6 and GPT-5.3 Codex models, SSH git packages, and dynamic API key resolution via shell commands.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.52.0 https://github.com/earendil-works/pi.git
$ git checkout v0.52.0
└──▷ USE IT
Pull API keys from a secrets manager or keychain at runtime instead of storing plaintext keys in auth.json.
json
copy
# In auth.json:
{
"openai": "!op read op://vault/openai/credential",
"anthropic": "$ANTHROPIC_API_KEY"
}
Adds Claude Opus 4.6 to the model catalog. Not checked yet Adds GPT-5.3 Codex to the model catalog (OpenAI Codex provider only). Not checked yet Supports SSH URLs for git packages. Not checked yet Enables dynamic API key resolution in auth.json via shell command (!command) and environment variable lookup. Not checked yet Model selectors now display the currently selected model name. Not checked yet
+1 more
show less
New minimal-mode.ts example extension demonstrating how to override built-in tool rendering for a minimal display mode. Not checked yet
6 details in Everything
Pi v0.51.6 adds a configurable resume keybinding and smarter slash command triggering.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.51.6 https://github.com/earendil-works/pi.git
$ git checkout v0.51.6
└──▷ USE IT
Bind a key to open the session resume selector so you can quickly return to a previous session without reaching for the mouse.
json
copy
# In your keybindings config (see docs/keybindings.md)
{ "key": "ctrl+r", "action": "resume" }
Adds resume as a configurable keybinding action to open the session resume selector, on par with newSession, tree, and fork. Not checked yet Slash command menu now triggers on the first line even when other lines contain content, enabling commands to be prepended to existing text. Not checked yet
2 details in Everything
Share URLs now default to the pi.dev domain.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.51.4 https://github.com/earendil-works/pi.git
$ git checkout v0.51.4
Pi v0.51.3 adds extension command discovery via ExtensionAPI.getCommands() and local path support for pi install/pi remove.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.51.3 https://github.com/earendil-works/pi.git
$ git checkout v0.51.3
└──▷ TRY IT
Install a locally developed extension package by path instead of a registry name.
copy
$ pi install ./my-extension
Adds ExtensionAPI.getCommands() so extensions can enumerate available slash commands (extensions, prompt templates, skills) for programmatic invocation. Not checked yet Exports SlashCommandInfo types to support command discovery integrations. Not checked yet Adds a commands.ts example extension demonstrating command discovery invocation patterns. Not checked yet Supports local filesystem paths in pi install and pi remove, with relative paths resolved against the settings file. Not checked yet
4 details in Everything
└──▷ BREAKING ON UPGRADE
! The RPC RPC Remote Procedure Call, a protocol that lets a program execute a function on another machine as if it were local, giving cyber tools a structured way to communicate across processes or hosts without managing raw sockets. get_commands response and SlashCommandSource type have the "template" value renamed to "prompt" — any code matching on "template" will break.
Pi v0.51.2 adds extension UI controls for tool output expansion and install-method-aware update instructions.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.51.2 https://github.com/earendil-works/pi.git
$ git checkout v0.51.2
Adds ExtensionUIContext methods getToolsExpanded and setToolsExpanded so extensions can programmatically control tool output expansion in the UI. Not checked yet Adds install method detection to display package-manager-specific update instructions (e.g., brew, apt) when an update is available. Not checked yet
2 details in Everything
Pi v0.51.1 adds a programmatic session-switching Extension API and a new terminal clear-on-shrink setting.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.51.1 https://github.com/earendil-works/pi.git
$ git checkout v0.51.1
New ctx.switchSession(sessionPath) Extension API lets extensions programmatically switch sessions. Not checked yet New terminal.clearOnShrink setting (also togglable via PI_CLEAR_ON_SHRINK=1) pins editor and footer to the bottom of the terminal when content shrinks. Not checked yet
2 details in Everything
Pi v0.51.0 adds Android/Termux support, bash spawn hooks, Nix/Guix compatibility, and a full Extension UI RPC RPC Remote Procedure Call, a protocol that lets a program execute a function on another machine as if it were local, giving cyber tools a structured way to communicate across processes or hosts without managing raw sockets. protocol.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.51.0 https://github.com/earendil-works/pi.git
$ git checkout v0.51.0
└──▷ TRY IT
Install and run Pi on an Android device via Termux.
copy
$ 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 && pi
Supports Android via Termux, with graceful clipboard fallback when termux-api is unavailable. Not checked yet New pi.setBashSpawnHook() API lets extensions intercept and modify bash commands, working directory, and environment variables before execution. Not checked yet Adds Linux ARM64 ARM64 A 64-bit CPU architecture from ARM Holdings, used in mobile chips, Apple Silicon, and cloud servers; cyber tools target it to run natively on those platforms instead of relying on emulation. musl (Alpine Linux) support via updated clipboard dependency. Not checked yet New PI_PACKAGE_DIR environment variable overrides the package path for Nix/Guix content-addressed package managers where store paths tokenize poorly. Not checked yet The /resume session picker gains a named-session-only filter toggle (Ctrl+N by default, configurable via toggleSessionNamedFilter keybinding). Not checked yet
+3 more
show less
New isToolCallEventType() type guard lets extension developers narrow ToolCallEvent types per tool for stronger TypeScript safety. Not checked yet Full Extension UI Protocol RPC documentation and examples enable headless clients to support interactive extension dialogs and notifications. Not checked yet Exports discoverAndLoadExtensions from the package, enabling extension testing without a local repo clone. Not checked yet
8 details in Everything
└──▷ BREAKING ON UPGRADE
! The ToolDefinition.execute parameter order has changed from (toolCallId, params, onUpdate, ctx, signal) to (toolCallId, params, signal, onUpdate, ctx). Any existing extension that implements execute must swap the signal and onUpdate parameters or it will break.
Pi v0.50.9 adds prompt cache retention control and a new titlebar spinner extension example.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.50.9 https://github.com/earendil-works/pi.git
$ git checkout v0.50.9
New cacheRetention stream option lets you control prompt cache retention duration with provider-specific mappings, defaulting to short retention. Not checked yet New titlebar-spinner.ts example extension displays a braille spinner animation in the terminal title bar while the agent is working. Not checked yet Adds PI_AI_ANTIGRAVITY_VERSION environment variable to the help text for easier version management. Not checked yet
3 details in Everything
Pi v0.50.8 adds threaded session picker, keybindable fork/tree/new commands, retry cap, Qwen OAuth, and new extension hooks.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.50.8 https://github.com/earendil-works/pi.git
$ git checkout v0.50.8
Adds newSession, tree, and fork keybinding actions for /new, /tree, and /fork commands (unbound by default). Not checked yet New retry.maxDelayMs setting caps how long Pi will wait on server-requested retry delays — requests exceeding the cap fail immediately with an informative error instead of hanging silently (default: 60 000 ms). Not checked yet Adds Threaded sort mode to the /resume session picker (now default), displaying sessions as a tree based on fork relationships with compact one-line format showing message count and age. Not checked yet Adds Qwen CLI OAuth provider extension example and modifyModels hook support for extension-registered providers at registration time. Not checked yet Supports Qwen thinking format for OpenAI-compatible completions via enable_thinking. Not checked yet
+2 more
show less
Adds resources_discover extension hook to supply additional skills, prompts, and themes on startup and reload. Not checked yet Adds sticky column tracking so the editor restores the preferred column when vertically navigating across short lines. Not checked yet
7 details in Everything
Pi v0.50.6 adds ctx.getSystemPrompt() for extensions to read the active system prompt.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.50.6 https://github.com/earendil-works/pi.git
$ git checkout v0.50.6
└──▷ USE IT
Inspect or branch logic in an extension based on the active system prompt.
javascript
copy
const prompt = ctx.getSystemPrompt();
Pi v0.50.4 adds OSC 52 clipboard over SSH, Vercel AI Gateway routing, new RPC RPC Remote Procedure Call, a protocol that lets a program execute a function on another machine as if it were local, giving cyber tools a structured way to communicate across processes or hosts without managing raw sockets. command, and richer editor navigation.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.50.4 https://github.com/earendil-works/pi.git
$ git checkout v0.50.4
└──▷ TRY IT
Copy output to the local clipboard from an SSH or mosh session without clipboard frustration.
Enables /copy to work over SSH and mosh sessions via OSC 52 terminal escape sequence. Not checked yet Adds Vercel AI Gateway routing with provider failover and load balancing, configured via vercelGatewayRouting in models.json. Not checked yet New set_session_name RPC command lets headless clients set the session display name programmatically. Not checked yet Adds Bash/Readline-style character jump navigation: Ctrl+] forward, Ctrl+Alt+] backward. Not checked yet Adds Emacs-style Ctrl+B / Ctrl+F keybindings for word-level cursor navigation in the editor. Not checked yet
+2 more
show less
Editor now jumps to line start on Up at the first visual line, and line end on Down at the last visual line. Not checked yet New "none" option for doubleEscapeAction setting completely disables the double-escape shortcut. Not checked yet
7 details in Everything
Pi v0.50.3 adds Kimi For Coding (Moonshot AI) as a new provider via KIMI_API_KEY.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.50.3 https://github.com/earendil-works/pi.git
$ git checkout v0.50.3
Pi v0.50.2 adds Hugging Face provider, extended prompt caching, /files command, shell keybindings, and RPC RPC Remote Procedure Call, a protocol that lets a program execute a function on another machine as if it were local, giving cyber tools a structured way to communicate across processes or hosts without managing raw sockets. get_commands.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.50.2 https://github.com/earendil-works/pi.git
$ git checkout v0.50.2
└──▷ TRY IT
Use a Hugging Face model in place of another provider without changing your workflow.
copy
$ HF_TOKEN=hf_xxxxxxxxxxxx pi
Enable 24-hour prompt cache retention for OpenAI to reduce token costs on long, repeated context.
copy
$ PI_CACHE_RETENTION=long pi
Audit every file the AI has touched in the current session before committing changes.
Adds Hugging Face provider via OpenAI-compatible Inference Router — set HF_TOKEN to access HF models. Not checked yet New PI_CACHE_RETENTION=long env var enables 1-hour prompt caching for Anthropic and 24-hour for OpenAI, vs. short in-memory defaults. Not checked yet New /files command lists all file operations (read, write, edit) performed in the current session. Not checked yet Adds shell-style keybindings: alt+b/alt+f for word navigation and ctrl+d for forward character delete. Not checked yet New autocompleteMaxVisible setting (3–20 items, default 5) controls autocomplete dropdown height via /settings or settings.json. Not checked yet
+1 more
show less
New get_commands RPC method lets headless clients programmatically list available commands. Not checked yet
6 details in Everything
Pi v0.50.0 adds package management, custom providers, Azure OpenAI Responses, hot reload, and a new --verbose flag.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.50.0 https://github.com/earendil-works/pi.git
$ git checkout v0.50.0
└──▷ TRY IT
Reload all skills, themes, and extensions mid-session after editing them on disk.
Start Pi with full startup diagnostics visible, overriding a quiet-startup config.
New pi install, pi remove, pi update, and pi list commands for managing extension packages (npm/git sources). Not checked yet New pi config TUI TUI A text-based user interface that runs inside a terminal, using characters and ANSI escape codes to render menus, panes, and widgets without a graphical desktop, letting cyber tools ship rich interactivity with no GUI dependency. command to enable/disable package and top-level resources via glob patterns. Not checked yet New /reload command for hot-reloading extensions, skills, prompts, themes, and context files without restarting. Not checked yet Custom provider registration via pi.registerProvider() for proxies, OAuth/SSO SSO Single sign-on, using one identity provider to sign in to multiple applications. It reduces separate passwords and centralizes account and access management. flows, and non-standard streaming APIs. Not checked yet Adds azure-openai-responses provider supporting the Azure OpenAI Responses API with deployment-aware model mapping. Not checked yet
+12 more
show less
Adds OpenRouter OpenRouter A unified API gateway that routes requests to dozens of LLM providers under one endpoint, letting cyber tools swap or compare models without rewriting provider-specific integration code. routing support for custom models via the openRouterRouting field in model config. Not checked yet New --verbose CLI flag to override the quietStartup setting and show full startup output. Not checked yet New CLI flags --skill, --prompt-template, --theme, --no-prompt-templates, and --no-themes for resource selection at launch. Not checked yet Skill invocation messages are now collapsible in chat output, shown collapsed by default. Not checked yet Header values in models.json now support environment variable and shell command resolution, matching apiKey behavior. Not checked yet Glob pattern support (minimatch) in package filters, top-level settings arrays, and pi manifests. Not checked yet New markdown.codeBlockIndent setting to customize code block indentation in rendered output. Not checked yet HTTP proxy environment variable support for all API requests. Not checked yet Session renaming directly from the /resume picker via Ctrl+R . Not checked yet Session selector keybindings are now fully configurable. Not checked yet Footer now shows the active provider alongside the model when multiple providers are available. Not checked yet Exposes copyToClipboard utility for use by extensions. Not checked yet
17 details in Everything
└──▷ BREAKING ON UPGRADE
! Header values in models.json now resolve environment variables: if a literal header value matches an env var name, the env var's value is used instead, which may change behavior for existing configs.! External packages (npm/git) are now configured via the packages array in settings.json instead of extensions; existing npm:/git: entries in extensions are auto-migrated.! Resource loading now uses ResourceLoader only and settings.json uses arrays for extensions, skills, prompts, and themes.! discoverAuthStorage and discoverModels are removed from the SDK; AuthStorage and ModelRegistry now default to ~/.pi/agent paths unless you pass an agentDir.! The /resume picker sort toggle is moved from Ctrl+R to Ctrl+S (freeing Ctrl+R for session rename).
Pi v0.49.3 adds inline bash expansion, AI image-gen extension, custom share viewer URLs, and a new word-delete hotkey.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.49.3 https://github.com/earendil-works/pi.git
$ git checkout v0.49.3
└──▷ TRY IT
Run an inline shell command inside a prompt without leaving Pi — useful for injecting dynamic values like timestamps or file contents.
copy
$ # In a Pi prompt, type:
Summarize this file: !{cat README.md}
New markdown.codeBlockIndent setting to customize code block indentation in rendered output. Not checked yet New inline-bash.ts example extension that expands !{command} patterns inline within prompts. Not checked yet New antigravity-image-gen.ts example extension for AI image generation via Google Antigravity. Not checked yet New PI_SHARE_VIEWER_URL environment variable to point Pi at a custom share viewer URL. Not checked yet Adds Alt+Delete hotkey for deleting a word forwards in the editor. Not checked yet
5 details in Everything
└──▷ BREAKING ON UPGRADE
! The tree selector label filter shortcut is changed from l to Shift+L ; any workflow or muscle-memory relying on l to filter labels will now need to use Shift+L .
Pi v0.49.2 adds AWS container credential detection, quiet startup, and richer HTML exports with JSONL JSONL A text format where each line is a self-contained, valid JSON object, making it easy to stream, append, and process large datasets line by line without parsing a full JSON array into memory. download.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.49.2 https://github.com/earendil-works/pi.git
$ git checkout v0.49.2
Supports AWS credential detection for ECS ECS Elastic Common Schema, an open specification maintained by Elastic that defines a standard field naming convention for log and event data, letting cyber tools share and correlate records without per-source field mapping. /Kubernetes environments via AWS_CONTAINER_CREDENTIALS_RELATIVE_URI, AWS_CONTAINER_CREDENTIALS_FULL_URI, and AWS_WEB_IDENTITY_TOKEN_FILE. Not checked yet Adds quiet startup setting configurable via /settings. Not checked yet HTML exports now include a JSONL download button and jump-to-last-message navigation. Not checked yet Adds widgetPlacement option in pi.addWidget() for controlling extension widget placement. Not checked yet
4 details in Everything
└──▷ BREAKING ON UPGRADE
! The strictResponsesPairing compat option has been removed from the models.json schema.
Pi v0.49.1 adds undo in interactive mode, richer session management, shell-command API key retrieval, and Azure Responses pairing support.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.49.1 https://github.com/earendil-works/pi.git
$ git checkout v0.49.1
└──▷ USE IT
Pull an API key from macOS Keychain instead of storing it in plaintext in models.json.
json
copy
"apiKey": "!security find-generic-password -ws 'anthropic'"
Undo the last action while working in interactive mode without leaving the session.
📍 Ctrl+-
While reviewing past sessions in /resume, toggle full path display or delete a session without leaving the selector.
copy
$ Ctrl+P # toggle path display
Ctrl+D # delete selected session (with inline confirmation)
Adds strictResponsesPairing compat option for custom OpenAI Responses models on Azure. Not checked yet Session selector (/resume) gains path display toggle (Ctrl+P ) and inline session deletion (Ctrl+D ). Not checked yet Adds undo support in interactive mode via Ctrl+- hotkey. Not checked yet API keys in models.json can now be sourced from shell commands using the ! prefix, enabling integration with system keychains (e.g., macOS Keychain). Not checked yet Share URLs now use hash fragments (#) instead of query strings, keeping session IDs out of server logs. Not checked yet
5 details in Everything
Pi v0.49.0 adds Emacs-style kill ring editing, per-entry labels via ExtensionAPI, and programmatic context compaction context compaction Condensing an AI conversation or working history to free space in the model's context window. A summary preserves useful information, but details can be lost. .
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.49.0 https://github.com/earendil-works/pi.git
$ git checkout v0.49.0
└──▷ TRY IT
Tag a specific conversation entry with a label from within a Pi extension.
copy
$ pi.setLabel(entryId, "high-priority")
Check remaining context budget and trigger compaction before it fills, from an extension.
copy
$ const usage = ctx.getContextUsage();
if (usage.used / usage.total > 0.8) {
await ctx.compact();
}
Adds pi.setLabel(entryId, label) to the ExtensionAPI for setting per-entry labels programmatically from extensions. Not checked yet Exports keyHint, appKeyHint, editorKey, appKey, and rawKeyHint so extensions can format keybinding hints consistently. Not checked yet Adds showHardwareCursor setting to control cursor visibility while retaining IME positioning support. Not checked yet Adds Emacs-style kill ring editing with yank, yank-pop, Alt+letter handling, and Alt+D delete-word-forward in the interactive editor. Not checked yet Adds ctx.compact() and ctx.getContextUsage() to extension contexts for programmatic compaction and context-usage inspection. Not checked yet
+1 more
show less
Exports VERSION from the package index for use in extensions and custom headers. Not checked yet
6 details in Everything
└──▷ BREAKING ON UPGRADE
! The pi-internal:// path resolution has been removed from the read tool — any extension or workflow relying on pi-internal:// URIs will break.
Pi v0.48.0 adds shell alias support, extension argument completions, and bash-style prompt template slicing
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.48.0 https://github.com/earendil-works/pi.git
$ git checkout v0.48.0
└──▷ USE IT
Silence startup banner output for a cleaner experience when piping Pi into scripts or using it in CI
json
copy
# In your Pi config:
"quietStartup": true
Provide tab-completions for custom extension command arguments to speed up practitioner workflows
javascript
copy
pi.registerCommand({
name: "scan",
getArgumentCompletions: async (args) => ["--target", "--profile", "--output"],
execute: async (args) => { /* ... */ }
});
New quietStartup setting silences the version header, loaded context info, and model scope line on startup Not checked yet New shellCommandPrefix setting prepends a command to every bash execution, enabling alias expansion in non-interactive shells Not checked yet New editorPaddingX setting controls horizontal padding (0–3) in the input editor Not checked yet Extension commands can now expose argument auto-completions via getArgumentCompletions in pi.registerCommand() Not checked yet Exports getShellConfig so extensions can detect and respond to the user's shell environment Not checked yet
+4 more
show less
Adds bash-style argument slicing for prompt templates Not checked yet Bash tool now displays the configured timeout value in the UI when a timeout is set Not checked yet navigateTree() gains replaceInstructions option to override the default summarization prompt, and a label option to tag branch summary entries Not checked yet Adds thinkingText and selectedBg fields to the theme schema Not checked yet
9 details in Everything
└──▷ BREAKING ON UPGRADE
! Hardware cursor is now disabled by default; the previous opt-out env var PI_NO_HARDWARE_CURSOR=1 is replaced by PI_HARDWARE_CURSOR=1 to opt in.
Pi v0.47.0 adds OpenAI Codex support, an extension input-intercept event, and Tree mode filter shortcuts.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.47.0 https://github.com/earendil-works/pi.git
$ git checkout v0.47.0
└──▷ TRY IT
Run Pi against OpenAI's Codex models for allowlisted environments with prompt caching across turns.
copy
$ OPENAI_API_KEY=<your-key> pi --provider openai-codex 'Review this file for hardcoded credentials' src/config.ts
Adds OpenAI Codex provider support (gpt-5.1, gpt-5.2, gpt-5.1-codex-mini, gpt-5.2-codex) with prompt caching via session ID and reasoning signature retention across turns — enable with --provider openai-codex. Not checked yet New pi-internal:// URL scheme in the read tool lets the model access internal coding-agent documentation, READMEs, and examples directly. Not checked yet New input event in the extension system allows intercepting, transforming, or fully handling user input before the agent processes it, with result types continue, transform, and handled. Not checked yet Adds input-transform.ts extension example demonstrating input interception patterns including quick mode, instant commands, and source routing. Not checked yet Custom tool HTML export: extensions implementing renderCall/renderResult now render with ANSI-to-HTML color conversion in /share and /export output. Not checked yet
+2 more
show less
Direct filter shortcuts in Tree mode: Ctrl+D (default), Ctrl+T (no-tools), Ctrl+U (user-only), Ctrl+L (labeled-only), Ctrl+A (all). Not checked yet Skill commands (/skill:name) now expand in AgentSession, enabling their use in RPC RPC Remote Procedure Call, a protocol that lets a program execute a function on another machine as if it were local, giving cyber tools a structured way to communicate across processes or hosts without managing raw sockets. and print modes and allowing the input event to intercept them before expansion. Not checked yet
7 details in Everything
└──▷ BREAKING ON UPGRADE
! Extensions using Editor directly must now pass TUITUI A text-based user interface that runs inside a terminal, using characters and ANSI escape codes to render menus, panes, and widgets without a graphical desktop, letting cyber tools ship rich interactivity with no GUI dependency. as the first constructor argument: new Editor(tui, theme) . The tui parameter is available in extension factory functions.
Pi v0.46.0 adds MiniMax China provider, fuzzy edit matching, APPEND_SYSTEM.md support, and enhanced session search.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.46.0 https://github.com/earendil-works/pi.git
$ git checkout v0.46.0
└──▷ TRY IT
Search past sessions by regex pattern to quickly locate a specific investigation, or press Ctrl+R to switch to most-recent ordering.
copy
$ # In the session picker, type: re:CVE-2024-\d+ to filter sessions by regex, or Ctrl+R to toggle sort mode
Adds APPEND_SYSTEM.md support to append custom instructions to the system prompt without modifying the base prompt. Not checked yet Edit tool now uses fuzzy matching as fallback, tolerating trailing whitespace, smart quotes, Unicode dashes, and special spaces. Not checked yet Session picker search gains Ctrl+R to toggle between fuzzy and most-recent sorting, plus quoted phrase matching and re: regex mode. Not checked yet Adds MiniMax China (minimax-cn) as a new provider. Not checked yet Adds gpt-5.2-codex model support for GitHub Copilot and OpenCode Zen providers. Not checked yet
+2 more
show less
Exports getAgentDir for use in extensions. Not checked yet Shows loaded prompt templates on startup for visibility into active configuration. Not checked yet
7 details in Everything
Pi v0.45.4 adds Vercel AI Gateway provider support and new extension examples for custom UI workflows.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.45.4 https://github.com/earendil-works/pi.git
$ git checkout v0.45.4
└──▷ TRY IT
Route requests through the Vercel AI Gateway instead of a direct provider — useful when centralizing auth or rate-limiting across teams.
copy
$ AI_GATEWAY_API_KEY=<your-key> pi --provider vercel-ai-gateway
Adds experimental Vercel AI Gateway provider support via --provider vercel-ai-gateway and AI_GATEWAY_API_KEY environment variable. Not checked yet New summarize.ts extension example for summarizing conversations using custom UI and an external model. Not checked yet New questionnaire.ts extension example for multi-question input with tab bar navigation. Not checked yet Enhanced plan-mode/ extension example with explicit step tracking and a progress widget. Not checked yet Switches image processing from sharp to wasm-vips, eliminating native build requirements. Not checked yet
5 details in Everything
Pi v0.45.0 adds MiniMax and Amazon Bedrock providers, model reordering in /scoped-models, and a bash sandbox extension example.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.45.0 https://github.com/earendil-works/pi.git
$ git checkout v0.45.0
Adds MiniMax provider support via MINIMAX_API_KEY environment variable and minimax/MiniMax-M2.1 model identifier. Not checked yet Adds Amazon Bedrock provider support (experimental, tested with Anthropic Claude models) as a new LLM LLM A large language model, a neural network trained on large amounts of text to recognize patterns and generate language. Applications use it for tasks such as answering, summarizing and writing code. backend. Not checked yet Enables Alt+Up/Down reordering of enabled models in /scoped-models; order persists on Ctrl+S save and controls Ctrl+P cycling sequence. Not checked yet Adds sandbox/ extension example demonstrating OS-level bash sandboxing sandboxing Running code inside a restricted environment that limits what it can access or change. The isolation reduces the impact of mistakes or untrusted code, depending on the sandbox's controls. via @anthropic-ai/sandbox-runtime with per-project configuration. Not checked yet
4 details in Everything
Pi v0.44.0 adds session naming, fuzzy settings search, and page-jump navigation in the session selector.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.44.0 https://github.com/earendil-works/pi.git
$ git checkout v0.44.0
└──▷ TRY IT
Give the current session a meaningful name so forked sessions are easy to tell apart in the session selector.
copy
$ /name threat-hunting-2024-q2
New /name <name> command sets a display name for the current session in the session selector, useful for distinguishing forked sessions. Not checked yet Extensions can programmatically get and set session names via new pi.setSessionName() and pi.getSessionName() APIs. Not checked yet New notify.ts extension example demonstrates desktop notifications via the OSC 777 escape sequence. Not checked yet Page-up/down navigation in /resume session selector jumps by 5 items at a time. Not checked yet Fuzzy search in /settings menu lets you type to filter settings by label. Not checked yet
5 details in Everything
└──▷ BREAKING ON UPGRADE
! pi.getAllTools() now returns ToolInfo[] (with name and description) instead of string[]; extensions that only need names must use .map(t => t.name) .
Pi v0.43.0 adds /scoped-models cycling, skill slash commands with fuzzy autocomplete, and new extension hooks for model changes and custom working messages.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.43.0 https://github.com/earendil-works/pi.git
$ git checkout v0.43.0
└──▷ TRY IT
Restrict Ctrl+P model cycling to only your preferred models for the current session, then persist the selection.
Invoke a loaded skill directly from the command line using its registered slash command, with fuzzy matching if you forget the full name.
copy
$ /skill:brave-search what CVEs were published this week?
Show a custom status message in the UI while your extension is doing async work during streaming.
copy
$ ctx.ui.setWorkingMessage("Fetching threat intel...");
New /scoped-models command lets you enable/disable models for Ctrl+P cycling; use Ctrl+S to persist choices to settings.json. Not checked yet Loaded skills are now registered as /skill:name slash commands for quick access; toggle via /settings or skills.enableSkillCommands. Not checked yet Slash command autocomplete now uses fuzzy matching (e.g., /skbra matches /skill:brave-search). Not checked yet New model_select extension hook fires on model changes (via /model, cycling, or session restore) with source and previousModel fields. Not checked yet New ctx.ui.setWorkingMessage() extension API lets extensions customize the 'Working...' message during streaming. Not checked yet
+5 more
show less
New SessionInfo.cwd field exposes a session's working directory; /resume All view now displays session cwd with loading progress. Not checked yet SessionManager.list() and SessionManager.listAll() now accept an optional onProgress callback for progress updates. Not checked yet New SessionListProgress type export for use with progress callbacks. Not checked yet /tree branch summarization now offers three options: No summary , Summarize , and Summarize with custom prompt ; custom prompts are appended to default summarization instructions. Not checked yet Tab in the /resume selector toggles between current-folder and all sessions. Not checked yet
10 details in Everything
└──▷ BREAKING ON UPGRADE
! The /branch command is renamed to /fork; RPC RPC Remote Procedure Call, a protocol that lets a program execute a function on another machine as if it were local, giving cyber tools a structured way to communicate across processes or hosts without managing raw sockets. branch → fork and get_branch_messages → get_fork_messages; SDK branch() → fork() and getBranchMessages() → getForkMessages() ; AgentSession branch() → fork() and getUserMessagesForBranching() → getUserMessagesForForking() ; extension events session_before_branch → session_before_fork and session_branch → session_fork; settings value doubleEscapeAction: "branch" → "fork".! Extension editor (ctx.ui.editor() ) submit key changed from Ctrl+Enter to Enter (Shift+Enter now inserts newlines); extensions with hardcoded ctrl+enter hints need updating.! SessionManager.list() and SessionManager.listAll() are now async, returning Promise<SessionInfo[]>; all callers must be updated to await them.
Pi v0.42.2 adds smarter model switching, a custom footer API, and a hotkey to recover queued messages.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.42.2 https://github.com/earendil-works/pi.git
$ git checkout v0.42.2
└──▷ TRY IT
Jump directly to a specific provider's model when multiple providers offer the same model name.
copy
$ /model openai/gpt-4
Adds pre-filtering and exact-match auto-selection to /model <search>, with provider/model syntax (e.g., /model openai/gpt-4) to disambiguate across providers. Not checked yet Introduces FooterDataProvider API: ctx.ui.setFooter() gains a third footerData parameter exposing getGitBranch() , getExtensionStatuses() , and onBranchChange() for reactive custom footers. Not checked yet Adds Alt+Up hotkey to restore queued steering or follow-up messages back into the editor without aborting the current run. Not checked yet
3 details in Everything
Pi v0.39.0 adds remote SSH tool execution, --no-tools flag, Wayland clipboard, and runtime theme switching for extensions.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.39.0 https://github.com/earendil-works/pi.git
$ git checkout v0.39.0
└──▷ TRY IT
Strip all built-in tools from a session so only your extension-provided tools are available — useful for tightly scoped, extension-only workflows.
Adds --no-tools flag to disable all built-in tools, enabling pure extension-defined tool setups. Not checked yet Adds pluggable operations interfaces (ReadOperations, WriteOperations, BashOperations, GrepOperations, etc.) for routing built-in tool calls over SSH or other transports. Not checked yet Adds user_bash event so extensions can intercept and redirect user !/!! shell commands to remote systems. Not checked yet Adds setActiveTools() to ExtensionAPI for dynamically managing the active tool set at runtime. Not checked yet Adds ctx.ui.getAllThemes() , ctx.ui.getTheme(name) , and ctx.ui.setTheme(name | Theme) for extensions to list, load, and switch themes at runtime. Not checked yet
+5 more
show less
Adds Wayland clipboard support for the /copy command via wl-copy with xclip/xsel fallback. Not checked yet Adds experimental { overlay: true } option to ctx.ui.custom() for floating modal components that composite over existing content without clearing the screen. Not checked yet Adds AgentSession.skills and AgentSession.skillWarnings properties to access loaded skills and warnings without re-running discovery. Not checked yet Ships ssh.ts example extension for remote tool execution via --ssh user@host:/path. Not checked yet Ships interactive-shell.ts example for running interactive commands (vim, git rebase, htop) with full terminal access via !i prefix or auto-detection. Not checked yet
10 details in Everything
└──▷ BREAKING ON UPGRADE
! The before_agent_start event now receives systemPrompt in the event object and must return systemPrompt (full replacement) instead of systemPromptAppend; extensions that were appending must now use the event.systemPrompt + extra pattern.! discoverSkills() now returns { skills: Skill[], warnings: SkillWarning[] } instead of Skill[]; callers that destructured or iterated the return value directly will break.
Pi v0.38.0 adds --no-extensions, async extension factories, UI dialog timeouts, custom editor components, and graceful shutdown control.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.38.0 https://github.com/earendil-works/pi.git
$ git checkout v0.38.0
└──▷ TRY IT
Run pi without scanning for extensions automatically, but still load a specific trusted extension by path.
copy
$ pi --no-extensions -e ./extensions/my-tool.ts
Suppress the startup version-check banner in automated or CI pipelines.
copy
$ PI_SKIP_VERSION_CHECK=1 pi 'summarize the latest alerts'
Customize token budgets per thinking level for a token-based provider in settings.
json
copy
{
"thinkingBudgets": {
"low": 1024,
"medium": 8192,
"high": 32768
}
}
Adds --no-extensions flag to disable auto-discovery of extensions while still loading explicit -e paths. Not checked yet Adds PI_SKIP_VERSION_CHECK environment variable to suppress startup version-update notifications. Not checked yet Adds thinkingBudgets setting to customize per-level token budgets for token-based providers. Not checked yet Extension UI dialogs (ctx.ui.select() , ctx.ui.confirm() , ctx.ui.input() ) now support a timeout option with live countdown display. Not checked yet Extensions can now provide custom editor components via ctx.ui.setEditorComponent() . Not checked yet
+3 more
show less
Extension factories can now be async, enabling dynamic imports and lazy-loaded dependencies. Not checked yet Adds ctx.shutdown() to extension contexts for requesting graceful shutdown, with mode-aware deferral (idle in interactive, post-response in RPC RPC Remote Procedure Call, a protocol that lets a program execute a function on another machine as if it were local, giving cyber tools a structured way to communicate across processes or hosts without managing raw sockets. , no-op in print). Not checked yet SDK exports InteractiveMode, runPrintMode() , and runRpcMode() for building custom run modes. Not checked yet
8 details in Everything
└──▷ BREAKING ON UPGRADE
! ctx.ui.custom() factory signature changed from (tui, theme, done) to (tui, theme, keybindings, done); custom components must add the new keybindings parameter.! LoadedExtension type renamed to Extension ; code referencing LoadedExtension will fail to compile.! LoadExtensionsResult.setUIContext() removed; replace with the runtime: ExtensionRuntime field.! ExtensionRunner constructor now requires runtime: ExtensionRuntime as a second parameter.! ExtensionRunner.initialize() signature changed from an options object to positional params (actions, contextActions, commandContextActions?, uiContext?).! ExtensionRunner.getHasUI() renamed to hasUI() ; calls to getHasUI() will break.! OpenAI Codex model aliases gpt-5, gpt-5-mini, gpt-5-nano, and codex-mini-latest removed; replace with canonical IDs gpt-5.1, gpt-5.1-codex-mini, gpt-5.2, or gpt-5.2-codex.
Extension UI dialogs gain AbortSignal support for programmatic timeouts; HTML export improves Codex session visibility.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.37.6 https://github.com/earendil-works/pi.git
$ git checkout v0.37.6
└──▷ USE IT
Auto-dismiss a confirmation dialog after a timeout so an unattended extension doesn't hang indefinitely.
typescript
copy
const ac = new AbortController();
setTimeout(() => ac.abort(), 5000);
const confirmed = await ctx.ui.confirm("Proceed?", { signal: ac.signal });
Adds optional AbortSignal parameter to ctx.ui.select() , ctx.ui.confirm() , and ctx.ui.input() extension dialogs, enabling programmatic dismissal and timeout patterns. Not checked yet HTML export now includes bridge prompts in model change messages for Codex sessions. Not checked yet
2 details in Everything
Pi v0.37.5 adds runtime model/thinking controls, exported truncation utilities, and a full UI component library for extensions.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.37.5 https://github.com/earendil-works/pi.git
$ git checkout v0.37.5
└──▷ USE IT
Cap tool output to a safe byte budget before returning it, preventing context blowout on large command output.
typescript
copy
import { truncateTail, DEFAULT_MAX_BYTES } from "pi/tools";
const raw = await runShellCommand(cmd);
return truncateTail(raw, { maxBytes: DEFAULT_MAX_BYTES });
Adds setModel() , getThinkingLevel() , and setThinkingLevel() ExtensionAPI methods so extensions can switch model and thinking level at runtime. Not checked yet Exports truncation utilities (truncateHead, truncateTail, truncateLine, formatSize, DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, TruncationOptions, TruncationResult) for use in custom tools. Not checked yet Exports the full suite of built-in UI components (ArminComponent, AssistantMessageComponent, BashExecutionComponent, BorderedLoader, and 20+ more) plus utilities renderDiff and truncateToVisualLines for extension developers. Not checked yet New truncated-tool.ts example demonstrating output truncation with custom rendering for extensions. Not checked yet New preset.ts example demonstrating preset configurations with model, thinking, and tools switching. Not checked yet
+1 more
show less
New Common Patterns and Key Rules sections in docs/tui.md with copy-paste code for SelectList, BorderedLoader, SettingsList, setStatus, setWidget, and setFooter. Not checked yet
6 details in Everything
Pi v0.37.0 adds headless OAuth over SSH, per-message shareable URLs, and a claude-rules extension example.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.37.0 https://github.com/earendil-works/pi.git
$ git checkout v0.37.0
Adds headless OAuth login with paste-based URL/code entry, enabling authentication over SSH sessions without a DISPLAY environment variable. Not checked yet Adds copy-link button in the share viewer to generate URLs that navigate directly to a specific message. Not checked yet Adds claude-rules extension example that loads .claude/rules/ entries into the system prompt. Not checked yet OpenAI Codex provider now sets thinking level separately from model selection, with the provider clamping to each model's supported range. Not checked yet
4 details in Everything
└──▷ BREAKING ON UPGRADE
! OpenAI Codex per-thinking-level model variants have been removed; thinking level must now be set separately.
Pi v0.36.0 adds experimental OpenAI Codex OAuth so ChatGPT Plus/Pro subscribers can access Codex models without a separate API key.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.36.0 https://github.com/earendil-works/pi.git
$ git checkout v0.36.0
└──▷ TRY IT
Authenticate as a ChatGPT Plus/Pro subscriber to access Codex models without a standalone API key.
copy
$ /login openai-codex
Pi v0.35.0 unifies hooks and custom tools into a single extensions system with a richer API and renames slash commands to prompt templates.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.35.0 https://github.com/earendil-works/pi.git
$ git checkout v0.35.0
└──▷ TRY IT
Load a safety-check extension and a custom todo tool in one flag instead of separate --hook / --tool flags.
copy
$ pi --extension ./safety.ts -e ./todo.ts
Publish a multi-file extension as an npm package by declaring entry points in its package.json pi field.
json
copy
{
"name": "my-extension-package",
"dependencies": { "zod": "^3.0.0" },
"pi": {
"extensions": ["./src/main.ts", "./src/tools.ts"]
}
}
Introduces unified extensions system — hooks and custom tools are now a single concept discovered from extensions/ directories, configured via one --extension / -e flag and one extensions key in settings.json. Not checked yet Extensions now support npm package.json manifests with declared entry points and dependencies (resolved via jiti), enabling extensions to be published to and installed from npm. Not checked yet Custom tools registered via pi.registerTool() now receive the same full ctx object as event handlers, giving them access to UI prompts, session management, and all other context capabilities. Not checked yet New extension API surface: pi.registerCommand() , pi.registerShortcut() , pi.registerFlag() , pi.registerMessageRenderer() , pi.appendEntry() , pi.getActiveTools() / pi.setActiveTools() , pi.getAllTools() , pi.events event bus for cross-extension communication. Not checked yet New UI API: ctx.ui.setStatus() (persistent per-extension footer status), ctx.ui.setWidget() (widget above editor), ctx.ui.setTitle() (terminal window title), ctx.ui.custom() (full TUI TUI A text-based user interface that runs inside a terminal, using characters and ANSI escape codes to render menus, panes, and widgets without a graphical desktop, letting cyber tools ship rich interactivity with no GUI dependency. component with keyboard handling), ctx.ui.editor() (multi-line editor with external editor support). Not checked yet
+2 more
show less
Renames slash commands to prompt templates ; commands/ directories are auto-migrated to prompts/ on startup. Not checked yet Session format bumped to version 3; existing sessions are automatically migrated on first load (message role hookMessage → custom). Not checked yet
7 details in Everything
└──▷ BREAKING ON UPGRADE
! The hooks and customTools arrays in settings.json are replaced by a single extensions array; existing configs must be updated manually.! The --hook and --tool CLI flags are replaced by --extension / -e; invocations using the old flags will break.! Extension source files must be moved from hooks/ and tools/ directories to extensions/; deprecation warnings are shown on startup but old paths are not auto-migrated.! SDK: HookAPI, HookContext, HookCommandContext, HookUIContext, CustomToolAPI, CustomToolContext, CustomToolUIContext, CustomTool, CustomToolFactory, HookMessage types are renamed — existing TypeScript extensions will fail to compile without updates.! SDK: discoverAndLoadHooks() , discoverAndLoadCustomTools() , loadHooks() , loadCustomTools() are replaced by discoverAndLoadExtensions() and loadExtensions() .! SDK: HookRunner is renamed to ExtensionRunner; wrapToolsWithHooks() / wrapToolWithHooks() are renamed to wrapToolsWithExtensions() / wrapToolWithExtensions() .! SDK CreateAgentSessionOptions: .hooks is removed; .additionalHookPaths → .additionalExtensionPaths; .preloadedHooks → .preloadedExtensions; .customTools type changed from Array<{ path?; tool: CustomTool }> to ToolDefinition[]; .additionalCustomToolPaths merged into .additionalExtensionPaths; .slashCommands → .promptTemplates.! SDK AgentSession: .hookRunner → .extensionRunner; .fileCommands → .promptTemplates; .sendHookMessage() → .sendCustomMessage() .! SDK: FileSlashCommand, LoadSlashCommandsOptions types and discoverSlashCommands() , loadSlashCommands() , expandSlashCommand() , getCommandsDir() functions are renamed; callers must update imports.! Session files with message role hookMessage are migrated to custom on first load under the new session version 3 format.
Pi v0.34.1 adds a Hook API method to dynamically set the terminal window/tab title from hooks.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.34.1 https://github.com/earendil-works/pi.git
$ git checkout v0.34.1
└──▷ TRY IT
Update the terminal tab title from a hook to reflect the current task or context at a glance.
copy
$ ctx.ui.setTitle("My Custom Title")
Pi v0.34.0 adds dynamic system prompt injection prompt injection An attack where text the model reads, such as a web page, file or tool result, carries instructions that override the user's. It is the main security risk for agents with tools. , multi-message hook returns, and runtime tool toggling via hooks.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.34.0 https://github.com/earendil-works/pi.git
$ git checkout v0.34.0
└──▷ TRY IT
Restrict the agent to safe read-only tools at startup, then let a hook re-enable bash mid-session based on user confirmation.
copy
$ pi --tools read,grep,find,ls
# Inside a hook, after user confirms:
# pi.setActiveTools(['read', 'grep', 'find', 'ls', 'bash'])
Enables before_agent_start hook handlers to return systemPromptAppend to dynamically inject text into the system prompt per turn; multiple hooks' appends are concatenated. Not checked yet Allows before_agent_start handlers to return and inject multiple messages in a single turn, not just the first. Not checked yet Expands the tool registry to include all built-in tools (read, bash, edit, write, grep, find, ls) even when --tools restricts the initially active set, letting hooks enable any registered tool via pi.setActiveTools() . Not checked yet Automatically rebuilds the system prompt — including tool descriptions and guidelines — whenever the active tool set changes via setActiveTools() . Not checked yet Adds example hook tools.ts providing an interactive /tools command to enable/disable tools with session persistence. Not checked yet
+2 more
show less
Adds example hook pirate.ts demonstrating systemPromptAppend to alter agent persona at runtime. Not checked yet Displays full stack traces for hook errors to aid debugging. Not checked yet
7 details in Everything
Pi v0.33.0 adds clipboard image paste, configurable keybindings, and clean-exit slash commands.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.33.0 https://github.com/earendil-works/pi.git
$ git checkout v0.33.0
└──▷ TRY IT
Exit cleanly after a session, ensuring all hook and tool cleanup handlers finish before the process terminates.
Supports pasting clipboard images via Ctrl+V — images are saved to a temp file and attached to the message (macOS, Windows, Linux/X11). Not checked yet Adds configurable keybindings via ~/.pi/agent/keybindings.json, covering editor navigation, deletion, and app actions like model cycling, with support for multiple bindings per action. Not checked yet New /quit and /exit slash commands exit the application gracefully, properly awaiting hook and custom tool cleanup handlers before terminating. Not checked yet
3 details in Everything
└──▷ BREAKING ON UPGRADE
! All isXxx() key detection functions (isEnter() , isEscape() , isCtrlC() , etc.) have been removed from @mariozechner/pi-tui; replace them with matchesKey(data, keyId) (e.g., matchesKey(data, "enter") , matchesKey(data, "ctrl+c") ). Hooks and custom tools using ctx.ui.custom() with keyboard input handling will break without this change.
Pi v0.32.2 adds $ARGUMENTS syntax for slash commands and enables slash/hook commands during streaming.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.32.2 https://github.com/earendil-works/pi.git
$ git checkout v0.32.2
└──▷ TRY IT
Use the new $ARGUMENTS syntax in a custom slash command definition to match Claude/Codex-style templates.
copy
$ # In your slash command file:
echo 'Summarise the following: $ARGUMENTS' > ~/.pi/commands/summarise.txt
Adds $ARGUMENTS as an alternative to $@ in custom slash commands, aligning with Claude, Codex, and OpenCode conventions — both syntaxes remain supported. Not checked yet Slash commands and hook commands now work during agent streaming: hook commands execute immediately, file-based slash commands are queued via steer/followUp. Not checked yet New streamingBehavior option ("steer" or "followUp") on prompt() lets callers specify queuing behavior when the agent is mid-stream. Not checked yet RPC RPC Remote Procedure Call, a protocol that lets a program execute a function on another machine as if it were local, giving cyber tools a structured way to communicate across processes or hosts without managing raw sockets. prompt command now accepts an optional streamingBehavior field for remote streaming-state control. Not checked yet
4 details in Everything
Pi v0.32.1 adds !!command syntax to run shell commands hidden from LLM LLM A large language model, a neural network trained on large amounts of text to recognize patterns and generate language. Applications use it for tasks such as answering, summarizing and writing code. context.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.32.1 https://github.com/earendil-works/pi.git
$ git checkout v0.32.1
└──▷ TRY IT
Run a command containing secrets or sensitive output without exposing it to the LLM's context window context window The maximum amount of text, counted in tokens, a model can take in and produce in one request. Everything the model knows about the task has to fit inside it. .
copy
$ !!cat ~/.aws/credentials
Pi v0.32.0 adds Vertex AI support, proxy overrides in models.json, auto image resizing, and splits message delivery into steer/followUp APIs.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.32.0 https://github.com/earendil-works/pi.git
$ git checkout v0.32.0
└──▷ USE IT
Proxy a built-in provider through an internal gateway without losing its model list, by overriding only baseUrl in models.json.
json
copy
{
"providers": {
"openai": {
"baseUrl": "https://my-internal-gateway.example.com/openai"
}
}
}
Enable automatic image resizing so large screenshots are down-sampled before being sent to the model, reducing token usage.
json
copy
{
"images": {
"autoResize": true
}
}
Adds steer(text) and followUp(text) methods to AgentSession, replacing queueMessage() , with distinct delivery semantics: steer interrupts mid-run, followUp waits until the agent finishes. Not checked yet Adds steeringMode and followUpMode settings to settings.json, replacing queueMode, with automatic migration of existing settings files. Not checked yet Adds deliverAs: "followUp" option to pi.sendMessage() second parameter (now options?: { triggerTurn?, deliverAs? }), enabling follow-up delivery from hooks. Not checked yet Adds steer and follow_up RPC RPC Remote Procedure Call, a protocol that lets a program execute a function on another machine as if it were local, giving cyber tools a structured way to communicate across processes or hosts without managing raw sockets. commands, set_steering_mode and set_follow_up_mode RPC commands, and steeringMode/followUpMode fields on RpcSessionState, replacing the old queue_message/set_queue_mode surface. Not checked yet Adds doubleEscapeAction key to settings.json (also configurable via /settings) to choose whether double-escape with empty editor opens /tree (default) or /branch. Not checked yet
+6 more
show less
Adds google-vertex provider for accessing Gemini models via Google Cloud Vertex AI using Application Default Credentials. Not checked yet Adds built-in provider overrides in models.json: set baseUrl to proxy a built-in provider while keeping its models, or define models to fully replace the provider. Not checked yet Adds images.autoResize key to settings.json (also configurable via /settings) to automatically resize images larger than 2000x2000 and inject original dimensions into the prompt. Not checked yet Adds Alt+Enter keybind to queue follow-up messages while the agent is streaming. Not checked yet Exports Theme and ThemeColor types for hooks using ctx.ui.custom() . Not checked yet Terminal window title now displays pi - dirname to identify which project session is active. Not checked yet
11 details in Everything
└──▷ BREAKING ON UPGRADE
! AgentSession.queueMessage() is removed; use steer() for mid-run interrupts or followUp() for post-run delivery.! queueMode getter on AgentSession is replaced by steeringMode and followUpMode getters.! setQueueMode() on AgentSession is replaced by setSteeringMode() and setFollowUpMode() .! queuedMessageCount on AgentSession is renamed to pendingMessageCount.! getQueuedMessages() on AgentSession is replaced by getSteeringMessages() and getFollowUpMessages() .! clearQueue() on AgentSession now returns { steering: string[], followUp: string[] } instead of a flat array.! hasQueuedMessages() on AgentSession is renamed to hasPendingMessages() .! pi.sendMessage() second parameter changed from triggerTurn?: boolean to options?: { triggerTurn?, deliverAs? }; callers passing a bare boolean must be updated.! queue_message RPC command replaced by steer and follow_up commands.! set_queue_mode RPC command replaced by set_steering_mode and set_follow_up_mode commands.! RpcSessionState.queueMode field replaced by steeringMode and followUpMode fields.! The Queue mode settings UI entry is split into Steering mode and Follow-up mode .
Pi v0.31.0 adds session trees with in-place branching, a restructured hooks/tools API, structured compaction with file tracking, and new UI commands.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.31.0 https://github.com/earendil-works/pi.git
$ git checkout v0.31.0
└──▷ USE IT
Discover available models and resolve an API key using the new ModelRegistry, replacing the old resolveApiKey callback pattern.
typescript
copy
import { discoverAuthStorage, discoverModels } from "@mariozechner/pi-coding-agent";
const authStorage = discoverAuthStorage(); // ~/.pi/agent/auth.json
const modelRegistry = discoverModels(authStorage); // + ~/.pi/agent/models.json
const model = modelRegistry.find("anthropic", "claude-sonnet-4-20250514");
const apiKey = await modelRegistry.getApiKey(model);
const available = await modelRegistry.getAvailable();
Register a custom slash command in a hook that waits for the agent to finish before branching from a chosen entry.
typescript
copy
pi.registerCommand("branch-here", {
description: "Branch session from a specific entry",
async handler(ctx) {
await ctx.waitForIdle();
const entries = ctx.sessionManager.getBranch();
const target = entries[entries.length - 2]; // second-to-last entry
await ctx.branch(target.id);
}
});
Sessions now use a tree structure with id/parentId fields, enabling in-place branching via the new /tree command; existing sessions are auto-migrated from v1 to v2 on first load. Not checked yet New /tree interactive navigator supports search, ←/→ paging, filter modes toggled with Ctrl+O (default → no-tools → user-only → labeled-only → all), and l to bookmark entries as LabelEntry. Not checked yet New /share command uploads a session as a secret GitHub gist and returns a shareable URL via shittycodingagent.ai. Not checked yet Adds enabledModels key to settings.json as an allowlist for models, mirroring the --models CLI flag. Not checked yet New ModelRegistry class (discoverModels, discoverAuthStorage) resolves model discovery and API key lookup from ~/.pi/agent/auth.json and ~/.pi/agent/models.json; exposed to hooks and tools via ctx.modelRegistry. Not checked yet
+29 more
show less
Hooks API gains granular session events: session_start, session_before_switch, session_switch (with reason: "new" | "resume"), session_before_branch, session_branch, session_before_compact, session_compact, session_shutdown, session_before_tree, session_tree, before_agent_start, and context. Not checked yet New hook API method pi.sendMessage(message, triggerTurn?) replaces pi.send() and creates a CustomMessageEntry. Not checked yet New hook API method pi.appendEntry(customType, data?) for persisting hook state without exposing it to the LLM LLM A large language model, a neural network trained on large amounts of text to recognize patterns and generate language. Applications use it for tasks such as answering, summarizing and writing code. context. Not checked yet New hook API method pi.registerCommand(name, options) for registering custom slash commands whose handlers receive HookCommandContext. Not checked yet New hook API method pi.registerMessageRenderer(customType, renderer) for custom TUI TUI A text-based user interface that runs inside a terminal, using characters and ANSI escape codes to render menus, panes, and widgets without a graphical desktop, letting cyber tools ship rich interactivity with no GUI dependency. rendering of hook entry types. Not checked yet New hook context methods available in all events: ctx.isIdle() , ctx.abort() , ctx.hasQueuedMessages() . Not checked yet New UI helpers on ctx.ui: editor(title, prefill?) for multi-line editing with Ctrl+G external editor support, custom(component) for full TUI component rendering, setStatus(key, text) for persistent footer status text, and theme getter for theme-colored text. Not checked yet New HookCommandContext-only methods for slash commands: ctx.waitForIdle() , ctx.newSession(options?) , ctx.branch(entryId) , ctx.navigateTree(targetId, options?) . Not checked yet New ctx.modelRegistry and ctx.model on hook context for API key resolution. Not checked yet Custom tools execute signature reordered to execute(toolCallId, params, onUpdate, ctx, signal?) and gains CustomToolContext with sessionManager, modelRegistry, model, isIdle() , hasQueuedMessages() , and abort() . Not checked yet New SessionManager tree methods: getTree() , getBranch() , getLeafId() , getLeafEntry() , getEntry() , getChildren() , getLabel() . Not checked yet New SessionManager append methods: appendCustomEntry() , appendCustomMessageEntry() , appendLabelChange() . Not checked yet New SessionManager branch methods: branch(entryId) , branchWithSummary() . Not checked yet New AgentSession method navigateTree(targetId, options?) for in-place session tree navigation. Not checked yet New AgentSession method newSession(options?) accepts optional parentSession for lineage tracking. Not checked yet SDK adds sendHookMessage(message, triggerTurn?) for hook message injection. Not checked yet RPC RPC Remote Procedure Call, a protocol that lets a program execute a function on another machine as if it were local, giving cyber tools a structured way to communicate across processes or hosts without managing raw sockets. prompt command replaces attachments field with images field using ImageContent format; auto_compaction_start gains reason field ("threshold" or "overflow"); auto_compaction_end gains willRetry field; compact response now includes full CompactionResult with summary, firstKeptEntryId, tokensBefore, and details. Not checked yet RPC reset command replaced by new_session command with optional parentSession field. Not checked yet Structured compaction now tracks readFiles and modifiedFiles arrays in details, accumulated across compactions, with clear sections: Goal, Progress, Key Information, File Operations. Not checked yet New before_compact and before_tree hook events allow custom compaction implementations. Not checked yet HTML export includes a tree visualization sidebar for navigating session branches. Not checked yet HTML export supports keyboard shortcuts Ctrl+T (toggle thinking blocks) and Ctrl+O (toggle tool outputs). Not checked yet HTML export supports theme-configurable background colors via optional export section in theme JSON. Not checked yet HTML export syntax highlighting now uses theme colors matching TUI rendering. Not checked yet New theme token thinkingText for configurable thinking block text color. Not checked yet New theme tokens required for custom themes: selectedBg, customMessageBg, customMessageText, customMessageLabel (total color count increased from 46 to 50). Not checked yet New BranchSummaryEntry, CustomEntry, CustomMessageEntry, and LabelEntry session entry types. Not checked yet Session entries now use short 8-character hex IDs instead of full UUIDs UUIDs A universally unique identifier, usually a 128-bit value used to identify an object across systems. It is designed to make independently generated identifiers unlikely to collide. . Not checked yet ANTHROPIC_OAUTH_TOKEN environment variable now takes precedence over ANTHROPIC_API_KEY for API key resolution. Not checked yet
34 details in Everything
└──▷ BREAKING ON UPGRADE
! HookEventContext is renamed to HookContext; existing hooks referencing HookEventContext will break.! The monolithic session hook event is removed; hooks must migrate to the granular events session_start, session_before_switch, session_switch, session_before_branch, session_branch, session_before_compact, session_compact, session_shutdown.! Session entries are no longer passed in hook or custom tool events; code must call ctx.sessionManager.getEntries() or ctx.sessionManager.getBranch() instead.! pi.send(text, attachments?) is replaced by pi.sendMessage(message, triggerTurn?) ; callers using the old signature will break.! ctx.exec() moved to pi.exec() ; existing hooks calling ctx.exec() will break.! ctx.sessionFile replaced by ctx.sessionManager.getSessionFile() .! hookTimeout setting removed; hooks no longer have timeouts.! resolveApiKey parameter removed; use ctx.modelRegistry.getApiKey(model) instead.! Custom tool type CustomAgentTool renamed to CustomTool; ToolAPI renamed to CustomToolAPI; ToolContext renamed to CustomToolContext; ToolSessionEvent renamed to CustomToolSessionEvent.! Custom tool execute parameter order changed from execute(toolCallId, params, signal, onUpdate) to execute(toolCallId, params, onUpdate, ctx, signal?) .! Custom tool dispose() method removed; use onSession with reason: "shutdown" for cleanup.! SDK type AppMessage renamed to AgentMessage; references will break.! SDK Attachment type removed; use ImageContent from @mariozechner/pi-ai and add images directly to message content arrays.! AgentSession.branch(entryIndex: number) changed to branch(entryId: string) .! AgentSession.getUserMessagesForBranching() now returns { entryId, text } instead of { entryIndex, text }.! AgentSession.reset() replaced by newSession(options?) .! SessionManager.saveXXX() methods renamed to appendXXX() (e.g., appendMessage, appendCompaction).! SessionManager.branchInPlace() renamed to branch() .! SessionManager.reset() replaced by newSession(options?) with optional parentSession.! SessionManager.createBranchedSessionFromEntries(entries, index) replaced by createBranchedSession(leafId) .! SessionHeader.branchedFrom renamed to SessionHeader.parentSession.! SessionManager.saveCompaction(entry) replaced by appendCompaction(summary, firstKeptEntryId, tokensBefore, details?) .! SessionManager.getEntries() now excludes the session header; use getHeader() separately.! SessionManager.getSessionFile() returns string | undefined (previously returned a value for in-memory sessions).! SDK export messageTransformer renamed to convertToLlm.! SDK SessionContext alias LoadedSession removed.! RPC branch command field entryIndex replaced by entryId; get_branch_messages response field entryIndex replaced by entryId.! RPC reset command replaced by new_session command.! Custom themes must add selectedBg, customMessageBg, customMessageText, and customMessageLabel color tokens or they will fail to load.
Pi v0.30.0 adds custom session directories and reverse model cycling in the TUI TUI A text-based user interface that runs inside a terminal, using characters and ANSI escape codes to render menus, panes, and widgets without a graphical desktop, letting cyber tools ship rich interactivity with no GUI dependency. .
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.30.0 https://github.com/earendil-works/pi.git
$ git checkout v0.30.0
└──▷ TRY IT
Resume a session stored in a project-specific directory rather than the default cwd-encoded path.
copy
$ pi --session-dir ./my-project-sessions -r
Continue the most recent session from a shared or team-defined session directory.
copy
$ pi --session-dir /shared/sessions -c
New --session-dir flag lets you store sessions in any directory instead of the default ~/.pi/agent/sessions/<encoded-cwd>/, compatible with -c (continue) and -r (resume) flags. Not checked yet Shift+Ctrl+P cycles models backward and Ctrl+L opens the model selector while retaining the current editor text. Not checked yet
2 details in Everything
└──▷ BREAKING ON UPGRADE
! The second parameter of SessionManager.create() , continueRecent() , and list() is renamed from agentDir to sessionDir with changed semantics: when provided it now specifies the session directory directly (no cwd encoding); when omitted it falls back to ~/.pi/agent/sessions/<encoded-cwd>/.! SessionManager.open() no longer accepts an agentDir parameter.
Pi v0.29.1 adds automatic SYSTEM.md prompt loading and a unified /settings command.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.29.1 https://github.com/earendil-works/pi.git
$ git checkout v0.29.1
└──▷ TRY IT
Override the default system prompt for a specific project without touching the CLI flag on every invocation.
copy
$ mkdir -p .pi && echo 'You are a security-focused assistant. Always recommend least-privilege principles.' > .pi/SYSTEM.md
Override all system prompt sources on the fly for a one-off session with a custom persona.
copy
$ pi --system-prompt ~/prompts/pentest.md
Adds automatic custom system prompt loading: Pi now auto-loads .pi/SYSTEM.md (project-local) or ~/.pi/agent/SYSTEM.md (global), with --system-prompt flag taking highest precedence. Not checked yet Introduces unified /settings command consolidating thinking level, theme, queue mode, auto-compact, show images, hide thinking, and collapse changelog into a single menu. Not checked yet
2 details in Everything
└──▷ BREAKING ON UPGRADE
! The /thinking, /queue, /theme, /autocompact, and /show-images commands are replaced by the new /settings menu.
Pi v0.29.0 adds word navigation, full Unicode input, and auto-spacing for pasted file paths in the CLI.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.29.0 https://github.com/earendil-works/pi.git
$ git checkout v0.29.0
Adds Ctrl+Left/Right and Alt+Left/Right word-by-word cursor movement in input fields. Not checked yet Supports full Unicode input beyond ASCII in all input fields. Not checked yet Auto-prepends a space when pasting a file path (starting with /, ~, or .) after a word character. Not checked yet
3 details in Everything
└──▷ BREAKING ON UPGRADE
! The /clear command is renamed to /new; hook event reasons before_clear and clear are renamed to before_new and new.
Pi v0.28.0 refactors credential storage to ~/.pi/agent/auth.json and overhauls the SDK API for auth and model management.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.28.0 https://github.com/earendil-works/pi.git
$ git checkout v0.28.0
Moves credential storage (API keys and OAuth tokens) from oauth.json and settings.json to ~/.pi/agent/auth.json; existing credentials are automatically migrated on first run. Not checked yet Adds AuthStorage class to the SDK for managing API keys and OAuth tokens, including AuthStorage.setRuntimeApiKey() for runtime overrides. Not checked yet Adds ModelRegistry class to the SDK for model discovery and API key resolution, with modelRegistry.find() for locating custom and built-in models. Not checked yet Adds discoverAuthStorage() and discoverModels() discovery functions to the SDK. Not checked yet Extends createAgentSession() to accept authStorage and modelRegistry options. Not checked yet
+1 more
show less
Adds getModel() from @mariozechner/pi-ai for accessing built-in models. Not checked yet
6 details in Everything
└──▷ BREAKING ON UPGRADE
! API keys are removed from settings.json; they must now be stored in ~/.pi/agent/auth.json.! SDK: configureOAuthStorage() , defaultGetApiKey() , findModel() , and discoverAvailableModels() are removed.! SDK: The getApiKey callback option to createAgentSession() is removed; use AuthStorage.setRuntimeApiKey() instead.
Pi v0.27.6 enhances compaction hooks with richer context and cleans up the SessionManager API.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.27.6 https://github.com/earendil-works/pi.git
$ git checkout v0.27.6
Adds previousSummary field to before_compact hook payloads so hooks can carry accumulated context across compactions. Not checked yet Adds messagesToKeep field to before_compact hook payloads exposing the recent turns that will survive compaction. Not checked yet Adds resolveApiKey function to before_compact hook payloads for flexible model key resolution across settings, OAuth, and env vars. Not checked yet Adds buildSessionContext() method to SessionManager for building LLM LLM A large language model, a neural network trained on large amounts of text to recognize patterns and generate language. Applications use it for tasks such as answering, summarizing and writing code. context from entries with compaction handling. Not checked yet Renames getEntries() (formerly loadEntries() ) on SessionManager to return a defensive copy of all session entries. Not checked yet
5 details in Everything
└──▷ BREAKING ON UPGRADE
! loadSessionFromEntries() is renamed to buildSessionContext() — any code calling loadSessionFromEntries() will break.! loadEntries() is renamed to getEntries() — any code calling loadEntries() will break.! The apiKey string field in before_compact hook payloads is removed in favor of resolveApiKey — hooks that read apiKey directly will break.
Pi v0.27.5 adds syntax highlighting and full markdown rendering to HTML exports.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.27.5 https://github.com/earendil-works/pi.git
$ git checkout v0.27.5
Adds syntax highlighting to code blocks in HTML exports using highlight.js, with theme-aware colors matching the TUI TUI A text-based user interface that runs inside a terminal, using characters and ANSI escape codes to render menus, panes, and widgets without a graphical desktop, letting cyber tools ship rich interactivity with no GUI dependency. . Not checked yet Adds server-side markdown rendering in HTML exports (tables, headings, code blocks, image rendering for user messages, TUI-style language markers, light/dark theme support). Not checked yet
2 details in Everything
Pi v0.27.3 adds persistent API key storage in settings.json with priority over environment variables.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.27.3 https://github.com/earendil-works/pi.git
$ git checkout v0.27.3
└──▷ USE IT
Persist an Anthropic API key in settings so it takes precedence over any environment variable across sessions.
json
copy
~/.pi/agent/settings.json:
{ "apiKeys": { "anthropic": "sk-..." } }
Hooks can now skip conversation restore on branch for checkpoint-style session management.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.27.2 https://github.com/earendil-works/pi.git
$ git checkout v0.27.2
Adds skipConversationRestore: true return value for before_branch hooks, allowing branched sessions to be created without restoring conversation messages. Not checked yet
1 detail in Everything
Pi v0.27.1 adds startup timing instrumentation via PI_TIMING=1 to profile interactive-mode performance.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.27.1 https://github.com/earendil-works/pi.git
$ git checkout v0.27.1
└──▷ TRY IT
Diagnose slow Pi startup times by seeing exactly where time is spent during initialization.
New PI_TIMING=1 env var prints a startup performance breakdown in interactive mode. Not checked yet
1 detail in Everything
Pi v0.27.0 adds cancellable before_* session lifecycle hooks and a shutdown hook for graceful exit handling.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.27.0 https://github.com/earendil-works/pi.git
$ git checkout v0.27.0
└──▷ TRY IT
Intercept a branch action before it happens and conditionally cancel it — useful for prompting the user or running pre-checks before a session branches.
copy
$ pi.on("session", (event) => {
if (event.reason === "before_branch") {
const allow = confirmBranch(); // your pre-check
if (!allow) return { cancel: true };
}
});
Run cleanup logic (flush logs, save state) when Pi is shutting down gracefully.
copy
$ pi.on("session", async (event) => {
if (event.reason === "shutdown") {
await flushLogs();
}
});
Adds before_switch, before_clear, and before_branch session hook variants that fire before their respective actions and can be cancelled by returning { cancel: true }. Not checked yet Adds shutdown session hook reason for graceful exit handling via pi.on("session", ...) . Not checked yet
2 details in Everything
└──▷ BREAKING ON UPGRADE
! The branch event is merged into the session event: BranchEvent, BranchEventResult types and pi.on("branch", ...) are removed; use pi.on("session", ...) with reason: "before_branch" | "branch" instead.! AgentSession.branch() now returns { cancelled } instead of { skipped }.! AgentSession.reset() and switchSession() now return boolean (false if cancelled by a hook) instead of their previous return types.! RPC RPC Remote Procedure Call, a protocol that lets a program execute a function on another machine as if it were local, giving cyber tools a structured way to communicate across processes or hosts without managing raw sockets. commands reset, switch_session, and branch now include cancelled in their response data instead of skipped.
Pi v0.26.0 adds a programmatic SDK with factory APIs for agent sessions, project-scoped settings, and flexible session management.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.26.0 https://github.com/earendil-works/pi.git
$ git checkout v0.26.0
└──▷ USE IT
Resume the most recent session programmatically to continue a long-running agent workflow without re-specifying session IDs.
typescript
copy
const session = await SessionManager.continueRecent();
New createAgentSession() SDK factory enables programmatic agent control over model, tools, hooks, skills, session persistence, and settings — ships with 12 examples. Not checked yet Supports project-specific settings loaded from <cwd>/.pi/settings.json, deep-merged over global ~/.pi/agent/settings.json, and treated as read-only for version control. Not checked yet New SettingsManager static factories: SettingsManager.create() for file-based settings, SettingsManager.inMemory() for testing, plus applyOverrides() for programmatic overrides. Not checked yet New SessionManager static factories: SessionManager.create() , SessionManager.open() , SessionManager.continueRecent() , SessionManager.inMemory() , and SessionManager.list() for flexible session lifecycle management. Not checked yet
4 details in Everything
Pi v0.25.3 adds Gemini 3 preview models, external editor support, process suspension, and granular skills filtering.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.25.3 https://github.com/earendil-works/pi.git
$ git checkout v0.25.3
└──▷ TRY IT
Filter to only skills matching a pattern at startup, e.g. to load only recon-related skills in a focused engagement.
copy
$ pi --skills 'recon*'
Draft a long, structured prompt in your preferred editor rather than the inline input, useful for complex multi-step instructions.
copy
$ # While in the pi prompt, press Ctrl+G to open $EDITOR, write your message, save and quit to send it.
Adds gemini-3-pro-preview and gemini-3-flash-preview models to the google-gemini-cli provider. Not checked yet New Ctrl+G keybinding opens the current message in $VISUAL or $EDITOR for external editing. Not checked yet New Ctrl+Z keybinding suspends Pi to the shell; resume with fg. Not checked yet Adds granular skill-source toggles: enableCodexUser, enableClaudeUser, enableClaudeProject, enablePiUser, enablePiProject, plus customDirectories and ignoredSkills settings. Not checked yet New --skills <patterns> CLI flag filters loaded skills by glob pattern; includeSkills setting and glob support for ignoredSkills also added. Not checked yet
5 details in Everything
Pi v0.25.0 adds interruptible tool execution and two free Google OAuth providers for Gemini and Claude models.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.25.0 https://github.com/earendil-works/pi.git
$ git checkout v0.25.0
└──▷ TRY IT
Authenticate with the Antigravity sandbox to get free access to Claude thinking and GPT-OSS OSS Open-source software: code whose licence permits anyone to inspect, modify, and redistribute it. Cyber tools build on it to reuse auditable libraries without licensing fees. models.
copy
$ # Inside pi, run:
/login
# Then select: Antigravity
Enables mid-task agent interruption: queuing a message while tools are running skips remaining tools and processes your new message immediately. Not checked yet New Google Gemini CLI OAuth provider: access Gemini 2.0/2.5 models for free via Google Cloud Code Assist using /login → Google Gemini CLI . Not checked yet New Google Antigravity OAuth provider: access Gemini 3, Claude sonnet/opus thinking models, and GPT-OSS models for free via /login → Antigravity . Not checked yet The /model command now filters to only the models specified by --models, preventing accidental selection of out-of-scope providers. Not checked yet
4 details in Everything
Pi v0.24.1 adds OAuth/model config exports for scripting and xhigh thinking level for gpt-5.2 models.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.24.1 https://github.com/earendil-works/pi.git
$ git checkout v0.24.1
└──▷ USE IT
When building a custom script around AgentSession, import OAuth and model helpers directly to reuse Pi's token storage without reimplementing auth.
javascript
copy
import { getAvailableModels, getApiKeyForModel, findModel, login, logout, getOAuthProviders } from '@mariozechner/pi-coding-agent';
Exports getAvailableModels, getApiKeyForModel, findModel, login, logout, and getOAuthProviders from @mariozechner/pi-coding-agent so custom AgentSession scripts can reuse OAuth token storage and model resolution. Not checked yet Adds xhigh thinking level option for gpt-5.2 and gpt-5.2-codex models in the thinking level selector and shift+tab cycling. Not checked yet
2 details in Everything
Pi v0.24.0 adds multi-agent orchestration, Kitty keyboard protocol, dynamic OAuth refresh, and a new /hotkeys command.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.24.0 https://github.com/earendil-works/pi.git
$ git checkout v0.24.0
└──▷ USE IT
Cancel a long-running shell command from a custom tool or hook if it exceeds a time limit.
typescript
copy
const result = await pi.exec("npm test", { timeout: 30000 });
if (result.killed) console.error("Process timed out and was terminated");
Display all available keyboard shortcuts at any point during a session.
Adds a comprehensive subagent orchestration example with scout/planner/reviewer/worker agents and multi-agent pipeline workflow commands. Not checked yet Enables pi.exec() to accept { signal, timeout } options in custom tools and hooks, with a killed flag on the result when the process is terminated. Not checked yet Supports the Kitty keyboard protocol, enabling Shift+Enter, Alt+Enter, Shift+Tab, Ctrl+D, and all Ctrl+key combos in Ghostty, Kitty, WezTerm, and other modern terminals. Not checked yet Adds dynamic OAuth token refresh for GitHub Copilot and Anthropic OAuth before each LLM LLM A large language model, a neural network trained on large amounts of text to recognize patterns and generate language. Applications use it for tasks such as answering, summarizing and writing code. call, preventing auth failures in long-running agent loops. Not checked yet Adds /hotkeys command to display all keyboard shortcuts in a formatted table. Not checked yet
+2 more
show less
Exports getMarkdownTheme() from @mariozechner/pi-coding-agent so custom tools can use the same markdown styling as the main UI. Not checked yet Renders markdown tables with proper top and bottom borders. Not checked yet
7 details in Everything
└──▷ BREAKING ON UPGRADE
! Auto-discovered custom tools now require an index.ts entry point inside a subdirectory: the old pattern ~/.pi/agent/tools/mytool.ts must become ~/.pi/agent/tools/mytool/index.ts. Explicit paths via --tool or settings.json still accept any .ts file.! The ToolResultEvent result: string field is removed; hook handlers must replace { result: "..." } returns with { content: [{ type: "text", text: "..." }] }, and access content via content: (TextContent | ImageContent)[] instead. ToolResultEventResult.result is renamed/removed — use content instead.
Pi v0.23.4 adds syntax highlighting for code blocks and word-level intra-line diff highlighting in the Edit tool.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.23.4 https://github.com/earendil-works/pi.git
$ git checkout v0.23.4
Adds syntax highlighting for markdown code blocks, read tool output, and write tool content using theme-aware VS Code-style colors. Not checked yet Edit tool now shows word-level (intra-line) diff highlighting with inverse highlighting for single-line changes; multi-line changes display all removed lines before added lines. Not checked yet
2 details in Everything
Pi v0.23.0 adds custom TypeScript tools with TUI TUI A text-based user interface that runs inside a terminal, using characters and ANSI escape codes to render menus, panes, and widgets without a graphical desktop, letting cyber tools ship rich interactivity with no GUI dependency. rendering, user interaction, and session-state persistence.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.23.0 https://github.com/earendil-works/pi.git
$ git checkout v0.23.0
└──▷ USE IT
Scaffold and run a custom TypeScript tool that prompts the user and persists state across pi sessions.
typescript
copy
# See examples/custom-tools/ for a working starter
# Tool skeleton (TypeScript):
export default {
onSession({ reason, entries }) {
if (reason === "start") { /* initialise state */ }
},
async run(pi) {
const choice = await pi.ui.select("Pick an option", ["A", "B"]);
await pi.ui.notify(`You picked ${choice}`);
}
};
New custom tools system: extend pi with TypeScript plugins that provide custom TUI rendering, prompt users via pi.ui (select, confirm, input, notify), and persist state across sessions via an onSession callback. Not checked yet Bundled hook and custom-tool examples in examples/hooks/ and examples/custom-tools/ shipped with npm and binary releases. Not checked yet
2 details in Everything
└──▷ BREAKING ON UPGRADE
! The session_start and session_switch hook events are replaced by a single session event; use event.reason ("start" | "switch" | "clear") to distinguish them, and read event.entries for state reconstruction.
Pi v0.22.4 adds --list-models to browse available models with fuzzy search and capability details.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.22.4 https://github.com/earendil-works/pi.git
$ git checkout v0.22.4
└──▷ TRY IT
Quickly find which vision-capable models you have API keys for before starting a multimodal multimodal Able to work with more than one type of input or output, such as text, images and audio. A multimodal model can combine information across those formats. task.
copy
$ pi --list-models image
Pi v0.22.0 adds GitHub Copilot OAuth login with access to Claude, GPT, Gemini, Grok, and more.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.22.0 https://github.com/earendil-works/pi.git
$ git checkout v0.22.0
Pi v0.21.0 adds inline image rendering for Kitty/iTerm2 terminals and Gemini 3 Pro thinking-level support.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.21.0 https://github.com/earendil-works/pi.git
$ git checkout v0.21.0
└──▷ TRY IT
Toggle inline image rendering on the fly during a session to see model-returned images rendered directly in the terminal.
Renders images inline in tool output on terminals supporting Kitty graphics protocol Kitty graphics protocol A terminal graphics protocol created by the Kitty terminal emulator project that lets applications render pixel-accurate images directly inside a terminal, giving cyber tools rich visual output without a GUI. (Kitty, Ghostty, WezTerm) or iTerm2 inline images, with aspect ratio preserved; toggle via /show-images command or terminal.showImages setting. Not checked yet Extends thinking level selector (Minimal/Low → Google LOW, Medium/High → Google HIGH) to Gemini 3 Pro models. Not checked yet
2 details in Everything
Pi v0.20.0 displays loaded skills on startup and adopts the SKILL.md directory convention.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.20.0 https://github.com/earendil-works/pi.git
$ git checkout v0.20.0
Displays loaded skills on startup in interactive mode so you can confirm which skills are active before issuing commands. Not checked yet
1 detail in Everything
└──▷ BREAKING ON UPGRADE
! Pi skills must now be named SKILL.md inside a directory (e.g. ~/.pi/agent/skills/foo/SKILL.md); the previous convention of any *.md file directly under the skills directory is no longer supported. Migrate by renaming ~/.pi/agent/skills/foo.md to ~/.pi/agent/skills/foo/SKILL.md.
Pi v0.19.0 adds a skills system for on-demand instruction loading and a --version flag.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.19.0 https://github.com/earendil-works/pi.git
$ git checkout v0.19.0
└──▷ TRY IT
Disable the skills system entirely when you want a clean, instruction-free agent run.
Check the installed Pi version quickly from the terminal.
New skills system auto-discovers and loads instruction files on demand from Claude Code, Codex CLI, and Pi-native skill directories, with descriptions surfaced in the system prompt. Not checked yet Adds --version / -v flag to print the current Pi version and exit. Not checked yet
2 details in Everything
Pi v0.18.2 adds auto-retry with exponential backoff for transient provider errors and line numbers in HTML exports.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.18.2 https://github.com/earendil-works/pi.git
$ git checkout v0.18.2
└──▷ USE IT
Tune retry behaviour for a slow or rate-limited provider without touching your workflow.
json
copy
# In settings.json
{
"retry": {
"enabled": true,
"maxRetries": 5,
"baseDelayMs": 2000
}
}
Adds auto-retry on transient provider errors (429, 500, 502–504) using exponential backoff (2s, 4s, 8s), with TUI TUI A text-based user interface that runs inside a terminal, using characters and ANSI escape codes to render menus, panes, and widgets without a graphical desktop, letting cyber tools ship rich interactivity with no GUI dependency. retry status display and Escape-to-cancel support. Not checked yet Exposes retry configuration via retry.enabled, retry.maxRetries, and retry.baseDelayMs in settings.json. Not checked yet Emits auto_retry_start and auto_retry_end events in RPC RPC Remote Procedure Call, a protocol that lets a program execute a function on another machine as if it were local, giving cyber tools a structured way to communicate across processes or hosts without managing raw sockets. mode for programmatic retry visibility. Not checked yet HTML exports now show line number ranges (e.g., file.txt:10-20) for read tool calls when offset/limit parameters are used, with yellow highlighting. Not checked yet
4 details in Everything
Pi v0.18.1 adds Mistral AI as a supported provider via MISTRAL_API_KEY.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.18.1 https://github.com/earendil-works/pi.git
$ git checkout v0.18.1
└──▷ TRY IT
Query a Mistral model by setting your API key before invoking Pi.
copy
$ export MISTRAL_API_KEY=<your-key>
pi <your-prompt>
Supports Mistral AI models as a new provider — set the MISTRAL_API_KEY environment variable to enable. Not checked yet
1 detail in Everything
Pi v0.13.1 adds flexible Windows shell configuration, supporting Cygwin, MSYS2, and custom bash environments.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.13.1 https://github.com/earendil-works/pi.git
$ git checkout v0.13.1
└──▷ TRY IT
Point Pi at a Cygwin bash installation on Windows instead of the default Git Bash.
copy
$ echo '{"shellPath": "C:\\cygwin64\\bin\\bash.exe"}' > ~/.pi/agent/settings.json
Pi v0.12.12 adds fuzzy model/session search, prompt history navigation, and a /resume command for mid-conversation session switching.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.12.12 https://github.com/earendil-works/pi.git
$ git checkout v0.12.12
└──▷ TRY IT
Switch to a previous session without restarting the agent — useful when you need to continue a different investigation mid-conversation.
Adds fuzzy search for models and sessions (e.g., codexmax matches gpt-5.1-codex-max) in the interactive selector. Not checked yet Adds prompt history navigation: browse up to 100 previously submitted prompts using Up/Down arrow keys when the editor is empty. Not checked yet New /resume command lets you switch to a different session mid-conversation via an interactive selector, without restarting the agent. Not checked yet Footer token counts now use M suffix for millions and shortened context display format (e.g., 61.3%/200k). Not checked yet
4 details in Everything
Pi v0.12.11 adds custom auth headers, a system-prompt layering flag, and a thinking-block visibility toggle.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.12.11 https://github.com/earendil-works/pi.git
$ git checkout v0.12.11
└──▷ USE IT
Enable bearer-token auth for a custom provider without manually specifying headers each time.
json
copy
{
"name": "my-provider",
"apiKey": "sk-...",
"authHeader": true,
"baseUrl": "https://my-provider.example.com/v1"
}
New authHeader option in models.json lets custom providers automatically inject Authorization: Bearer <apiKey> headers. Not checked yet New --append-system-prompt flag appends inline text or file contents to the system prompt without replacing the base prompt. Not checked yet New Ctrl+T shortcut toggles visibility of LLM LLM A large language model, a neural network trained on large amounts of text to recognize patterns and generate language. Applications use it for tasks such as answering, summarizing and writing code. thinking blocks to reduce visual clutter during long conversations. Not checked yet
3 details in Everything
Pi v0.12.9 adds /copy command to grab the last agent message straight to your clipboard.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.12.9 https://github.com/earendil-works/pi.git
$ git checkout v0.12.9
└──▷ TRY IT
After receiving a long Markdown-formatted agent response, copy it to clipboard for pasting into a report or ticket without losing formatting.
Pi v0.12.7 adds context compaction context compaction Condensing an AI conversation or working history to free space in the model's context window. A summary preserves useful information, but details can be lost. with manual and auto modes, plus branch source tracking for session lineage.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.12.7 https://github.com/earendil-works/pi.git
$ git checkout v0.12.7
└──▷ TRY IT
Manually compact a long session mid-conversation, directing the summary to focus on a specific area of work.
copy
$ /compact focus on the authentication module decisions and discard unrelated tangents
Enable auto-compaction so long-running agent sessions never stall due to context overflow.
Adds /compact [instructions] command to manually summarize older messages and reduce context usage, with optional custom instructions for the summary. Not checked yet Adds /autocompact toggle to automatically compact context when it reaches contextWindow - reserveTokens (default 16k reserve tokens). Not checked yet Compacted sessions display a collapsible summary in the TUI TUI A text-based user interface that runs inside a terminal, using characters and ANSI escape codes to render menus, panes, and widgets without a graphical desktop, letting cyber tools ship rich interactivity with no GUI dependency. (toggled with o key) and in HTML exports. Not checked yet RPC RPC Remote Procedure Call, a protocol that lets a program execute a function on another machine as if it were local, giving cyber tools a structured way to communicate across processes or hosts without managing raw sockets. mode gains a {"type":"compact"} command and auto-compaction support, emitting compaction events. Not checked yet Branched sessions now record branchedFrom in the session header to track the originating session file path. Not checked yet
5 details in Everything
Pi v0.12.5 adds configurable branding via piConfig in package.json for forks and white-labels.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.12.5 https://github.com/earendil-works/pi.git
$ git checkout v0.12.5
└──▷ USE IT
Rebrand the CLI for a fork by declaring piConfig in your package.json — no source changes required.
json
copy
{
"piConfig": {
"name": "mytool",
"configDir": ".mytool"
}
}
Supports forking/rebranding the CLI by setting piConfig.name and piConfig.configDir in package.json, updating the banner, help text, config paths, and error messages without code changes. Not checked yet
1 detail in Everything
Pi v0.12.4 adds a /debug slash command that logs terminal rendering diagnostics to disk.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.12.4 https://github.com/earendil-works/pi.git
$ git checkout v0.12.4
└──▷ TRY IT
Capture a rendering diagnostic snapshot when lines appear misaligned or truncated in your terminal.
New /debug slash command writes terminal width and all rendered lines with their visible widths to ~/.pi/agent/pi-debug.log for diagnosing rendering issues. Not checked yet
1 detail in Everything
Pi v0.12.0 ships pre-built standalone binaries for macOS, Linux, and Windows — no Node/Bun runtime required.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.12.0 https://github.com/earendil-works/pi.git
$ git checkout v0.12.0
Adds standalone self-contained binary builds via npm run build:binary, with pre-built releases for macOS (arm64/x64), Linux (x64/arm64), and Windows (x64) on GitHub Releases. Not checked yet
1 detail in Everything