mirror of
https://github.com/badlogic/pi-mono.git
synced 2026-11-05 23:37:25 +00:00
ca7460d16b
Replace the tsgo native preview with typescript@7.0.2 and port the check scripts to the TS 7 API. Target ES2024, drop useDefineForClassFields: false and unused decorator options, and enable verbatimModuleSyntax. Replace tsx with node plus the source resolver hook, passed to --import as a file URL. closes #9965
39 lines
1.4 KiB
Markdown
39 lines
1.4 KiB
Markdown
# Examples
|
|
|
|
Example code for the pi-coding-agent SDK, process integration, and extensions.
|
|
|
|
## CLI integration
|
|
|
|
[`rpc-client.ts`](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:
|
|
|
|
```bash
|
|
node examples/rpc-client.ts "Explain this repository"
|
|
```
|
|
|
|
## Directories
|
|
|
|
### [sdk/](sdk/)
|
|
Programmatic usage via `createAgentSession()`. Shows how to customize models, prompts, tools, extensions, and session management.
|
|
|
|
### [extensions/](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/](plugins/pi-example-plugin/)
|
|
An experimental plugin package that Pi automatically builds into separate Session-worker and TUI Chord facets.
|
|
|
|
## Documentation
|
|
|
|
- [SDK Examples](sdk/README.md)
|
|
- [CLI Integration](../docs/cli-integration.md)
|
|
- [Extensions Documentation](../docs/extensions.md)
|
|
- [Skills Documentation](../docs/skills.md)
|