pi-coding-agent Configuration & Customization Guide
Comprehensive reference for customizing pi-coding-agent (pi).
Reference Documents
Read the following documents as needed:
Context Files
- context-files.md - How pi loads
AGENTS.md/CLAUDE.mdcontext files and system prompt customization (SYSTEM.md,APPEND_SYSTEM.md).
Settings
- settings.md - All options for settings files (
~/.pi/agent/settings.json,.pi/settings.json). Model, theme, compaction, retry, and more.
Extensions
- extensions.md - How to create TypeScript extensions. Custom tools, event hooks, custom UI, command registration, etc.
- Extension examples - Numerous sample extensions.
Skills
- skills.md - How to create Agent Skills. SKILL.md format, frontmatter, discovery rules.
Prompt Templates
- prompt-templates.md - How to create prompt templates invoked via
/name. Argument support.
Package Management
- packages.md - How to share extensions, skills, themes, etc. as npm/git packages.
pi install,pi remove,pi update.
SDK (Programmatic Usage)
- sdk.md - How to use pi as a library to build custom UIs or automated pipelines.
- SDK examples - Step-by-step examples from minimal to full control.
Typical Configuration Workflow
- Global settings: Edit
~/.pi/agent/settings.json(shared across all projects) - Project settings: Edit
.pi/settings.json(project-specific, overrides global) - Add extensions: Place TypeScript files in
.pi/extensions/ - Add skills: Create
.pi/skills/<name>/SKILL.md - Prompt templates: Create
.pi/prompts/<name>.md - Use packages:
pi install npm:<package>orpi install git:<repo>
Use read to load the reference documents above as needed.
Source: yukukotani/pi-voice — distributed by TomeVault.