Pi Agent Core guide: extending a running TypeScript agent with an extension

Pi Agent Core: Extend a Running Agent Without a Rebuild (2026 Guide)

Pi Agent Core is a runtime-agnostic TypeScript agent loop. The short answer to the question people actually arrive with — how do I add a tool or a model provider to a running Pi agent without forking or repackaging it — is: write one TypeScript file that exports a default factory, call pi.registerTool() or pi.registerProvider() inside it, and pass the file with --extension. Pi loads it through jiti, so there is no compile, build or publish step. This refresh keeps the architecture and ecosystem material and adds the extension lifecycle, plus a registration record from our own fixture with its limits stated plainly. ...

June 20, 2026 · 14 min · baeseokjae