II.
AgentVersion overview
Reference · liveagentVersion:pi:ge-0-75-5
Pi CLI (>=0.77.0) overview
Inspect the raw attributes, linked wiki pages, and inbound or outbound graph edges for agentVersion:pi:ge-0-75-5.
Attributes
agentId
pi
aliases
[]
runtimeFamily
cli-harness
releaseChannel
stable
displayName
Pi CLI (>=0.77.0)
summary
Pi CLI coding agent current npm line with read, bash, edit, write tools and session management
sourcePackage
@earendil-works/pi-coding-agent
osSupport
- linux
- macos
- windows
agentProductId
versionRange
>=0.77.0
currentVersion
0.77.0
releasedAt
2026-05-29
upstreamReleaseTag
v0.77.0
releaseNotesUrl
cliCommand
pi
assimilationNotes
- Added --exclude-tools / -xt to disable selected built-in, extension, or custom tools while leaving the rest enabled.
- Headless Codex subscription login can use device-code auth for ChatGPT Plus/Pro Codex subscriptions.
- Extension input events expose streamingBehavior so extensions can distinguish idle prompts, mid-stream steers, and queued follow-ups.
- SIGTERM/SIGHUP exits now run extension session_shutdown cleanup and restore the terminal.
- OpenAI Codex Responses replay after switching from Anthropic extended-thinking sessions now generates unique fallback item IDs.
- Added --session-id <id> so automation can create or resume an exact project-local session.
- RPC bash accepts excludeFromContext to keep selected command output out of the next prompt.
- Codex Responses WebSocket/SSE waits are bounded by httpIdleTimeoutMs, websocketConnectTimeoutMs, and a 10s SSE response-header timeout.
- retry.provider.maxRetries controls provider retries, SDK retries default to zero, and quota/billing 429s are not retried behind Pi's retry handling.
- Codex Responses cache-affinity headers now send session-id instead of proxy-incompatible session_id.
releaseHighlights
- Added --session-id for scripts to create or resume an exact project-local session.
- RPC bash calls can pass excludeFromContext to keep command output out of the next prompt.
- Codex WebSocket/SSE waits are bounded, retry.provider.maxRetries controls provider retries, and SDK retries default to zero.
- Terminal editing improved for Apple Terminal Shift+Enter, Windows/JetBrains capability detection, and Unicode-aware word navigation.
- OpenAI Codex Responses cache-affinity headers now send session-id instead of proxy-incompatible session_id.
installMethods
minSchemaVersion
6.0.0
adapterMetadata
authMethods
- typeapi_keynameProvider API KeyenvVars
- ANTHROPIC_API_KEY
- OPENAI_API_KEY
authFiles
- ~/.pi/agent/settings.json
hostEnvSignals
- PI_RUN_ID
- PI_SESSION_ID
sessionDir
~/.pi/agent/sessions
sessionPersistence
file
approvalModes
- yolo
- prompt
capabilityFlags
canResume
true
canFork
false
supportsMultiTurn
true
sessionPersistence
file
supportsTextStreaming
true
supportsToolCallStreaming
true
supportsThinkingStreaming
false
supportsNativeTools
true
supportsMCP
false
supportsParallelToolCalls
false
requiresToolApproval
true
supportsThinking
false
supportsJsonMode
false
supportsStructuredOutput
false
structuredSessionTransport
none
sessionControlPlane
self-managed
supportsSkills
false
supportsAgentsMd
false
skillsFormat
none
supportsSubagentDispatch
false
supportsParallelExecution
false
maxParallelTasks
1
supportsInteractiveMode
true
supportsStdinInjection
true
supportsImageInput
false
supportsImageOutput
false
supportsFileAttachments
false
supportsPlugins
false
supportedPlatforms
- darwin
- linux
- win32
requiresGitRepo
false
requiresPty
false
runtimeHooks
preToolUse
nonblocking
postToolUse
nonblocking
sessionStart
nonblocking
sessionEnd
nonblocking
stop
nonblocking
userPromptSubmit
nonblocking
configSchema
configFormat
json
configFilePaths
- ~/.pi/agent/settings.json
compatFields
forceAdaptiveThinking
type
boolean
introducedIn
0.75.5
scope
custom-anthropic-compatible-model
retryFields
providerMaxRetries
path
retry.provider.maxRetries
introducedIn
0.76.0
notes
Controls Pi provider retries; SDK retries default to zero.
httpIdleTimeoutMs
path
httpIdleTimeoutMs
introducedIn
0.76.0
notes
Applies to OpenAI Codex Responses WebSocket idle waits.
websocketConnectTimeoutMs
path
websocketConnectTimeoutMs
introducedIn
0.76.0
notes
Bounds OpenAI Codex Responses WebSocket connect waits.
sessionControls
sessionIdFlag
--session-id
introducedIn
0.76.0
behavior
Create or resume an exact project-local session ID.
displayName
Pi
defaultModelId
default
interactiveSignals
turnCompletePattern
^>
exitOnNonInteractive
false
nonInteractiveMode
interactiveMode
hookSupport
interactive
sessionStart
unsupported
stop
unsupported
userPromptSubmit
unsupported
preToolUse
unsupported
sessionEnd
unsupported
nonInteractive
bridgeCapabilities
interactiveBridge
true
sessionResume
true
positionalPrompt
false
Outgoing edges
composed_of10
- agent-core-impl:pi.core@current·AgentCoreImplPi Core (current)
- agent-runtime-impl:pi.runtime@current·AgentRuntimeImplPi Runtime (current)
- agent-platform-impl:pi.platform@current·AgentPlatformImplPi Platform (current)
- agent-ui-impl:pi.ui@current·AgentUIImplPi UI (current) — tui-and-cli
- knowledge-fabric-impl:pi.knowledge@current·KnowledgeFabricImplPi Knowledge Fabric — CLAUDE.md (Claude Code compatible)
- agent-core-impl:pi.core@current·AgentCoreImplPi Core (current)
- agent-runtime-impl:pi.runtime@current·AgentRuntimeImplPi Runtime (current)
- agent-platform-impl:pi.platform@current·AgentPlatformImplPi Platform (current)
- agent-ui-impl:pi.ui@current·AgentUIImplPi UI (current) — tui-and-cli
- knowledge-fabric-impl:pi.knowledge@current·KnowledgeFabricImplPi Knowledge Fabric — CLAUDE.md (Claude Code compatible)
evidenced_by2
- evidence:pi-0-76-0-release·EvidenceSourcePi v0.76.0 release notes
- evidence:pi-0-76-0-release·EvidenceSourcePi v0.76.0 release notes
installed_via1
- install:npm·InstallMethodnpm (global)
sourced_from2
- evidence:pi-0-77-0-release·EvidenceSourcePi v0.77.0 release notes
- evidence:pi-0-77-0-release·EvidenceSourcePi v0.77.0 release notes
supports15
- capability:interactive-mode·CapabilityInteractive mode
- capability:stdin-injection·CapabilitySTDIN injection
- capability:can-resume·CapabilityCan resume
- capability:supports-compaction·CapabilitySupports context compaction
- capability:supports-prompt-templates·CapabilitySupports prompt templates
- capability:supports-session-management·CapabilitySupports session management
- capability:skills·CapabilitySkills
- capability:supports-thinking·CapabilitySupports thinking
- capability:interactive-mode·CapabilityInteractive mode
- capability:stdin-injection·CapabilitySTDIN injection
- capability:vision-input·CapabilityVision input
- capability:can-resume·CapabilityCan resume
- capability:supports-compaction·CapabilitySupports context compaction
- capability:supports-prompt-templates·CapabilitySupports prompt templates
- capability:supports-session-management·CapabilitySupports session management
uses_memory_system2
- memory-system:pi-memory·MemorySystemPi Memory
- memory-system:pi-memory·MemorySystemPi Memory
Incoming edges
applies_to_version2
- lifecycle-semantics:pi·LifecycleSemantics
- session-semantics:pi·SessionSemantics
bridges_for4
- adapter:agent-launch-adapter·Adapteragent-launch-adapter
- adapter:agent-comm-adapter·Adapteragent-comm-adapter
- adapter:hooks-adapter·Adapterhooks-adapter
- adapter:extensions-adapter·Adapterextensions-adapter
capability_of_version6
- capabilitySupport:pi:ge-0-0-0:skills·CapabilitySupport
- capabilitySupport:pi:ge-0-0-0:thinking·CapabilitySupport
- capabilitySupport:pi:ge-0-0-0:interactive-mode·CapabilitySupport
- capabilitySupport:pi:ge-0-0-0:stdin-injection·CapabilitySupport
- capabilitySupport:pi:ge-0-0-0:image-input·CapabilitySupport
- capabilitySupport:pi:ge-0-0-0:session-resume·CapabilitySupport
composes1
- knowledge-fabric-impl:pi.knowledge@current·KnowledgeFabricImplPi Knowledge Fabric — CLAUDE.md (Claude Code compatible)
emits_hook3
- hook-mapping:post-tool-use-pi·HookMapping
- hook-mapping:before-provider-request-pi·HookMapping
- hook-mapping:session-start-pi·HookMapping
has_version1
- agent:pi·AgentProductPi
references3
- evidence:pi-0-76-0-release·EvidenceSourcePi v0.76.0 release notes
- evidence:pi-0-77-0-release·EvidenceSourcePi v0.77.0 release notes
- evidence:pi-0-77-0-release-issue-541·EvidenceSourcePi v0.77.0 release notes for issue #541