mirror of https://github.com/badlogic/pi-mono.git synced 2026-11-05 23:37:25 +00:00

History

Armin Ronacher 540e174c72 feat(coding-agent): Virtual models (#10035 ) This adds experimental support for virtual models. A virtual model is a catalog entry that an extension registers with pi.registerVirtualModel(). It does not talk to a provider itself; for every request it picks a physical model and thinking level. The motivation is to make routing policies pluggable: plan on a strong model and implement on a cheap one, pick a model with a classifier, or move to a larger window when the context grows. Today this needs model switching by hand or hacks in prepareRequest. The selection stays virtual: model_change records it, resume restores it, and each response records the physical model and thinking level that produced it. Router state can be stored on the session branch, so it follows /tree and forks and survives compaction. Context limits, compaction and image sizing use the physical model a request was routed to. examples/extensions/jev-router.ts shows a full router that uses the Jev classifier to pick Sol or Terra for planning and hands off to Luna after the first edit. docs/virtual-models.md describes the API.		2026-09-28 23:30:45 +02:00
..
extensions	feat(coding-agent): Virtual models (#10035 )	2026-09-28 23:30:45 +02:00
plugins/pi-example-plugin	feat: add transactional replicated state	2026-09-21 16:07:59 +02:00
sdk	feat: build with TypeScript 7 and run sources with plain node	2026-09-25 13:14:33 +02:00
README.md	feat: build with TypeScript 7 and run sources with plain node	2026-09-25 13:14:33 +02:00
rpc-client.ts	feat: build with TypeScript 7 and run sources with plain node	2026-09-25 13:14:33 +02:00
rpc-extension-ui.ts	feat: build with TypeScript 7 and run sources with plain node	2026-09-25 13:14:33 +02:00

README.md

Examples

Example code for the pi-coding-agent SDK, process integration, and extensions.

CLI integration

rpc-client.ts uses the typed RpcClient to run Pi in a child process, stream events, and wait for the run to settle.

Build the coding-agent package before running it from a repository checkout:

node examples/rpc-client.ts "Explain this repository"

Directories

sdk/

Programmatic usage via createAgentSession(). Shows how to customize models, prompts, tools, extensions, and session management.

extensions/

Example extensions demonstrating:

Lifecycle event handlers (tool interception, safety gates, context modifications)
Custom tools (todo lists, questions, subagents, output truncation)
Commands and keyboard shortcuts
Custom UI (footers, headers, editors, overlays)
Git integration (checkpoints, auto-commit)
System prompt modifications and custom compaction
External integrations (SSH, file watchers, system theme sync)
Custom providers (Anthropic with custom streaming, GitLab Duo)

plugins/pi-example-plugin/

An experimental plugin package that Pi automatically builds into separate Session-worker and TUI Chord facets.