Examples

Example code for pi-coding-agent SDK and extensions.

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.

Documentation

• SDK Reference
• Extensions Documentation
• Skills Documentation