pi-cordis
作为由生命周期管理的 Cordis 运行时插件，为 ACRYL 提供 Pi 编码代理。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add pi-cordis@0.1.0Pi Cordis 以 pi-cordis 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
pi-cordis packages the Pi coding agent as a Cordis runtime
plugin. It provides a Pi SDK session through the host's existing Cordis tree,
so an ACRYL runtime can mount, remove, or replace Pi without making Pi the
owner of application composition.
pnpm add pi-cordis @deepseek-ai/cordis@4.0.1
Use a stable Loader row in a host that already provides loader:
- id: pi-engine
name: pi-cordis
config:
persistent: false
persistent: false keeps the Pi session in memory. Set persistent: true to
use Pi's session storage in the configured working directory. ACRYL's future
engine-neutral session record remains the owner of cross-engine continuity.
The plugin provides ctx.piEngine.
const sessionId = await ctx.piEngine.open()
ctx.piEngine.subscribe(event => observe(event))
await ctx.piEngine.prompt('Inspect this project')
await ctx.piEngine.abort()
Pi owns its agent loop, model runtime, session operations, and event stream. Cordis owns the Pi engine's service lifetime, subscriptions, cleanup, and replacement in the surrounding host.
pi-cordis keeps the Pi integration narrow and lifecycle-safe.
ctx.piEngine; they do not create or retain Pi SDK sessions directly.loader; it does
not assume a particular initialization sequence or create its own root.The repository includes pi/ as a shallow, one-commit Git submodule
from https://github.com/earendil-works/pi, pinned to upstream main.
pnpm run upstream:sync # restore the recorded pin
pnpm run upstream:update # deliberately fetch upstream main and update the pin
The submodule is source provenance only. The published package uses the pinned
@earendil-works/pi-coding-agent SDK and does not load source directly from
the checkout. See provenance.json for the exact source
revision and dependency mapping.
pi-cordis is an engine provider for ACRYL's selectable runtime host. The
--engine pi CLI selection, canonical cross-engine session record, and
DSH+Pi hybrid engine are subsequent integration work.
pi-cordis