Changelog

Credential storage refactored: API keys and OAuth tokens are now stored in ~/.pi/agent/auth.json instead of oauth.json and settings.json. Existing credentials are automatically migrated on first run. (#296)

SDK API changes (#296):

• Added AuthStorage class for credential management (API keys and OAuth tokens)
• Added ModelRegistry class for model discovery and API key resolution
• Added discoverAuthStorage() and discoverModels() discovery functions
• createAgentSession() now accepts authStorage and modelRegistry options
• Removed configureOAuthStorage(), defaultGetApiKey(), findModel(), discoverAvailableModels()
• Removed getApiKey callback option (use AuthStorage.setRuntimeApiKey() for runtime overrides)
• Use getModel() from @mariozechner/pi-ai for built-in models, modelRegistry.find() for custom models + built-in models
• See updated SDK documentation and README

Settings changes: Removed apiKeys from settings.json. Use auth.json instead. (#296)

Compaction hook improvements: The before_compact session event now includes:

• previousSummary: Summary from the last compaction (if any), so hooks can preserve accumulated context
• messagesToKeep: Messages that will be kept after the summary (recent turns), in addition to messagesToSummarize
• resolveApiKey: Function to resolve API keys for any model (checks settings, OAuth, env vars)
• Removed apiKey string in favor of resolveApiKey for more flexibility

SessionManager API cleanup:

• Renamed loadSessionFromEntries() to buildSessionContext() (builds LLM context from entries, handling compaction)
• Renamed loadEntries() to getEntries() (returns defensive copy of all session entries)
• Added buildSessionContext() method to SessionManager

SDK for programmatic usage: New createAgentSession() factory with full control over model, tools, hooks, skills, session persistence, and settings. Philosophy: "omit to discover, provide to override". Includes 12 examples and comprehensive documentation. (#272)

Project-specific settings: Settings now load from both ~/.pi/agent/settings.json (global) and <cwd>/.pi/settings.json (project). Project settings override global with deep merge for nested objects. Project settings are read-only (for version control). (#276)

SettingsManager static factories: SettingsManager.create(cwd?, agentDir?) for file-based settings, SettingsManager.inMemory(settings?) for testing. Added applyOverrides() for programmatic overrides.

SessionManager static factories: SessionManager.create(), SessionManager.open(), SessionManager.continueRecent(), SessionManager.inMemory(), SessionManager.list() for flexible session management.

Gemini 3 preview models: Added gemini-3-pro-preview and gemini-3-flash-preview to the google-gemini-cli provider. (#264 by @LukeFost)

External editor support: Press Ctrl+G to edit your message in an external editor. Uses $VISUAL or $EDITOR environment variable. On successful save, the message is replaced; on cancel, the original is kept. (#266 by @aliou)

Process suspension: Press Ctrl+Z to suspend pi and return to the shell. Resume with fg as usual. (#267 by @aliou)

Configurable skills directories: Added granular control over skill sources with enableCodexUser, enableClaudeUser, enableClaudeProject, enablePiUser, enablePiProject toggles, plus customDirectories and ignoredSkills settings. (#269 by @nicobailon)

Skills CLI filtering: Added --skills <patterns> flag for filtering skills with glob patterns. Also added includeSkills setting and glob pattern support for ignoredSkills. (#268)

Gemini image reading broken: Fixed the read tool returning images causing flaky/broken responses with Gemini models. Images in tool results are now properly formatted per the Gemini API spec.

Tab completion for absolute paths: Fixed tab completion producing //tmp instead of /tmp/. Also fixed symlinks to directories (like /tmp) not getting a trailing slash, which prevented continuing to tab through subdirectories.

Interruptible tool execution: Queuing a message while tools are executing now interrupts the current tool batch. Remaining tools are skipped with an error result, and your queued message is processed immediately. Useful for redirecting the agent mid-task. (#259 by @steipete)

Google Gemini CLI OAuth provider: Access Gemini 2.0/2.5 models for free via Google Cloud Code Assist. Login with /login and select "Google Gemini CLI". Uses your Google account with rate limits.

Google Antigravity OAuth provider: Access Gemini 3, Claude (sonnet/opus thinking models), and GPT-OSS models for free via Google's Antigravity sandbox. Login with /login and select "Antigravity". Uses your Google account with rate limits.